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About This Manual 



Who should use this manual ... 

The System/36 Source Entry Utility Guide is an introduction to SEU 
for the new or experienced SEU user. 

How this manual is arranged . . . 

Chapter 1 gives you a general description of what the Source Entry 
Utility (SEU) is and how it works. It shows you how to sign on, steps 
you through a quick general description of how to use SEU, and in 
this chapter, shows you how to enter or update a member. If you 
want to follow the example, you should make the highlighted entries. 

Chapter 2 begins the detailed section of the manual with ysihile Using 
SEU. It describes things you will see when using SEU, such as the 
SEU parameters, the status line, the command keys, the statement 
numbering, the printer, and what your choices are at the end of a job. 

Chapter 3 discusses in detail how SEU can be used. (Chapter 1 gives 
you a quick example of how SEU can be used). Chapter 3 is for 
reference when using SEU. 

Chapter 4 discusses the displays that are available with SEU to guide 
you as you enter statements. These displays were introduced briefly in 
Chapter 1 . 

Chapter 5 is for the programmer or anyone who wants more detailed 
information on SEU. This chapter includes a sample SEU run sheet 
and explains how SEU uses disk space. 
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What you should know . 



You should be familiar with data processing concepts (such as disk, 
file, and members) and with System/36 and its display stations as 
described in Learning About Your Computer, SC21 -901 8. 

You should also be familiar with the operation of your display station 
as described in the Operator's Guide for your particular display station. 

You shouki know how to use the keys on your keyboard, such as: 

• Cursor movement keys 

• Command keys 

• Field exit keys 

• Insert and delete keys 

• Error reset key. 

/f you need more information ... 

You might need some of the information in these manuals while using 
the SEU Guide: 

• Operating Your Computer, SC21 -9026, tells how to sign on or off 
the system, explains how to reply to messages, and answers 
general questions about operating the system. 

• System Reference, SC21 -9020, can be used for reference when 
using procedures, commands, and operation control language 
(OCL). 

• System l\/lessages, SC21 -7938, lists the system messages you may 
see when using the system. 

• Utilities Messages, SC21 -7939, explains the messages you may 
see when using the system utilities. 
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While you use this manual . . . 

If you would like more details about WSU, SDA, DFU, or Sort, see: 

• Work Station Utility Guide, SC21 -7905 

• Creating Displays: Screen Design Aid and System Support 
Program, SC21 -7902 

• Data File Utility Guide, SC21 -7900 

• Sort Guide, SC21 -7903 

If you would like more details about RPG II, COBOL, BASIC, 
FORTRAN IV, or Assembler, see: 

• Programming with RPG II, SC21 -9006 

• Programming with COBOL, SC21 -9007 

• Programming with BASIC, SC21 -9003 

• Programming with FORTRAN IV, SC21 -9005 

• Programming with Assembler, SC21 -7908 

If you would like more detail about System/36 forms, see: 

• RPG Control and File Description Specifications, GX21 -9092 

• RPG Extension and Line Counter Specifications, GX21 -9091 . 

• RPG Input Specifications, GX21 -9094 

• RPG Calculation Specifications, GX21 -9093 

• RPG Output Specifications, GX21 -9090 

• RPG Auto Report Specifications, GX21 -91 39 

• RPG Indicator Summary, GX21 -9095 

• RPG Telecommunications Specifications, GX2^ -9^^ 6 
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• RPG Debugging Temp/ate, GX21-9^ 29 

• COBOL Cod/ng Form, GX2S-^464 

. FORTRAN Coding Form, GX2B-1321 

• Assembler Coding Form, GX2^ -9219 

• Translation Table and Alternate Collating Sequence Coding Sheet, 
GX21-9096 

• Sort Specifications, GX21 -7957 

• Display Format Specifications, GX2\-9QQQ 

• WSU Job, Array, and File Specifications, GX2^ -9453 

• WSU Processing Specifications, GX21 -7936 

• WSU/$SFGR Debugging Template, GX21 -7926 

• Keyboard Template, GX21 -7929 

Summary of changes 

The following changes have been made for Release 3 Modification 0: 

• A new format selection has been added. This format lets you 
enter Help information for any text displays. The new format is 
DOC-H. 

• Formats for WSU-J, WSU-S, SFGR-S, and SFGR-H have been 
changed to include Ideographic Mode, Online Text, and 132 
Column entries. 

• SEU can be used on the 132 column capable IBM 3180 model 2, 
but all displays will be in 80 column mode. See the IBM 3180 
model 2 Display Station Users Guide, GA21 -9469, for more 
information. 

• Various technical and editorial changes have been made to 
improve the quality and usability of this manual. 
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The System/36 Source Entry Utility (SEU) helps you enter or make 
changes to statements in a source member or a procedure member. 
With SEU you can use: 



• Enter/update to create a source member, add statements to an 
existing member, or change statements in an existing member. 

• Copy/move to duplicate or relocate statements in a member. 

• Scan/replace to search through a member to locate a particular 
sequence of characters. You can update the located characters 
and optionally substitute the located set of characters with 
replacement characters. 

• Delete to remove statements from a member. 

• Include to copy statements from one member to another. 

• Translate to translate each message in your message member into 
another language. 
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Why Use SEU 



Because SEU prompts you for the information it needs, you will find it 
easy to use whether you are a new or experienced user, and whether 
you are a display station operator or a programmer. 

RPG programmers will find SEU helpful because it can check their 
RPG 11 or auto report statements for syntax errors as the statements 
are entered. 

You may use SEU to: , 

• Enter OCL statements for a procedure 

• Enter specifications for: 

- RPG II 

- COBOL 

- FORTRAN IV 

- BASIC 

- Assembler 

- Display formats ($SFGR or SDA) 

- WSU 

- Sort. 

• Make changes to any of the stored members. 

Note: Throughout this manual the term member refers to a 
procedure or a source member. 
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Before You Begin 



Before you begin using SEU, you might want to see the steps 
involved in SEU. 

Step 1 . Plan and Code: Before sitting down at the display station 
to enter a new member, you need to plan what statements you want 
to enter. You can do this using the program specification sheets. 





I 




Input Specifications 




F 






File Description 
Specifications 





Step 2. Signing On to SEU: Next you need to sign on to SEU by 
entering the SEU command. You are then asked for information about 
the member you want to work with. 

System/36 

r~n 





r \ 

LsEU ^ 













Step 3. SEU Sets Up a Wfork Area: SEU is loaded into main 
storage, and it sets aside a work file for you. (If you are working with 
an existing member, a copy of that member is placed in this work file 
for you.) 



System/36 




SEU Work File 
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Step 4. Enter or Update: Now you can enter or make changes to 
statements ih a member. SEU stores all new or changed statements in 
the work file. 



System/36 



Disk Storage 




SEU Work File 



Steps. End the SEU Job: When you end your job, SEU takes 
whatever is in the work file and stores it in the library you choose. 

System/36 
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First You Need to Sign On To SEU 



Once you have signed on to the system, you can sign on to SEU. You 
may have heard this referred to as accessing or calling SEU. Whatever 
you call it, it means making the utility available to you. SEU is easy to 
sign on to, you just type: 



> =^1 SEU 

and press the Enter key. You are prompted for any more information 
SEU needs. 

To help you understand how SEU works, this chapter gives a series of 
examples that step through several ways to use SEU with a new 
member. Now sign on to SEU and you can follow along at your 
display station. Because the example uses the library SEU LIB, you 
must either build SEU LIB before using the example, or enter the name 
of an existing library. You may build SEULIB with the BLDLIBR 
procedure. For information on the BLDLIBR procedure, see the 
System Reference manual. 

Next you will see the following display. For this example, type in the 
name of the member, the member type, and the name of your library: 




t Optional- 

Source entry «tfl1ty {SEU) is i'-%^^mm&^W^ you to create, 
change, retnove, and locate statements in source and procedure members 



Name of member to be created or updated 

Type of SEU men*er 

Name of member containing SEU formats . 

Length of statement , 

Name of library containing mender . . . 



A.F.P.R.S.T.W 



#S€§XTRA 




Note: Throughout these examples the entries that you should make 
are highlighted. To follow the example, type the entries exactly as 
shown. 

Press the Enter key to continue. 
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Name of Member to be Created or Updated 



This is the name of the member you are entering or want to change. 
The name can be from 1 to 8 characters long. For the example, type 
in AR230R and press the Field Exit key. 

Type of SEU Member 

This is the SEU type of the member to be entered or changed. For 
this example, we are entering part of an RPG program so enter an R. 

Name of Member Containing SEU Formats 

This is where the system stores the SEU-supplied displays you use to 
enter statements. For this example, leave the entry that SEU supplied 
(#SE@XTRA). 

Length of Statement 

This is how many characters long each statement can be. You do not 
have to enter a number here. For this example, leave this parameter 
blank and SEU will enter a length of 96 characters for you. 

Name of Library Containing Member 

The name of the library you are currently using is displayed in this 
parameter. For this example, you can leave the library name that is 
displayed or enter another name. The sample data from this example 
will be stored in the library you specify. 
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After You Sign On To SEU 



What is displayed after you sign on to SEU depends on wiiether the 
member already exists or is a member being created. Since you are 
entering a new member for this example, once you sign on to SEU a 
free-form display is shown to help you enter data. The free-form 
display (also called the Z-display) looks like this: 
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Displays That Guide You 



SEU provides several displays to guide you as you enter statements. 
You can see a list of all the displays provided by SEU, by pressing the 
Select Display command key (Cmd 3). Many of the displays 
correspond to a particular specification sheet (sometimes called a 
coding sheet) so that you can easily transfer your data or statements 
from the paper specification sheet to the display: 



IBM 



International Bulinien Machines Corporation 



RPG INPUT SPECIFICATIONS 



Program , 


Keying 
Instruction 


Graphic 
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Programmer | Date 


Key 
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Filename 
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RPG 
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Enter Field Name Here 
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Enter or update statement number 



. 0012.00 



The displays not only reflect the field positions on the specification 
sheet, they also accept only certain valid types of data. 

For example, if a field is numeric-only, the display will allow you to 
type only numeric data in those positions on the display. 
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Examples Using SEU 



The following examples illustrate the common uses of SEU, such as 
enter/ update, copy/move, and delete. Scan/replace, include, and 
message translate are explained in detail in Chapter 3. 

How to Enter Statements Using Enter/ Update 

Example 1 

To begin entering statements, use the information from the following 
specification sheets (Figure 1-1): 
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Figure 1-1. F- and l-Specif ications 
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To enter the first statement from the F-specification sheet, you need 
an F-dispiay to guide you. Press the Select Display command key 
(Cmd 3), and a list of SEU displays is shown: 




Select display 



WSU-J 
WSU-E 
WSU-T 
WSU-M 
WSU-S 
WSU-D 
WSU-C 
SFGR- 
SFGR- 
SFGR- 
D-COM 
SDRTH 
SORTRF 
SORTRC 
SORTF 
ASSEM 



er the number of the 



33 FORTRAN 

34 COBOL 

35 SDAS 
SDAH 
SDADI 
.SDAD2 





i5 SRT-FLD 
<»6 MICRSYS 
<i7 MICRSTCK 
48 



61 
62 
63 
64 



want . 
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If you have the Ideographic Character feature on your system and you 
are signed on to an ideographic-capable display station, you will see 
the following display when command key 3 (Cmd 3) is pressed. 
Notice that COMMAND is inserted into the list, and SORTH and the 
following selections have been moved one position. Also notice that 
DOC-H has been inserted between SDAD2 and AUTOR. 



Screen 67 with Command display 



Select display 



49 
50 
51 
5Z 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
6A 



Entar th« numb«r of thai specification display you want. . . . 



1 


Z 


17 HSU-J 


33 


2 


Z-LOWER 


18 MSU-E 


34 


3 


H 




55 


4 


U 


y HSU-T 


36 


5 


F 




37 


6 


6 




38 


7 


E 


It SFGR-S 


39 


8 


1 




40 


9 


T 


25 SF6R-H 


41 


10 


I 


^ S,F68-0 


42 


11 


J 




43 


12 


C 


28 cormAND 


44 


13 


0 


29 SORTH 


45 


14 


P 


30 SORTRF 


46 


15 


K 


31 SORTRC 


47 


16 


A 


32 SORTF 


48 



For an explanation of the Command display, see Chapter 4. 
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Enter the option number to select the display for the F-specification. 

When the F-display is shown, begin entering the F-specification as 
shown, using the Field Exit key (for numeric fields) or Field Advance 
key (-^1) to move from field to field. You do not need to enter the 
statement numbers (such as 0001.00, 0002.00) since SEU will 
provide them for you. For more information, see Statement 
Numbering in Chapter 2. 

If you accidentally press the wrong key, a blinking error message 
might be displayed and you will be unable to use the keyboard. In a 
case like this, simply press the Error Reset key and continue, or press 
the Help key for an explanation of the error message, then press the 
Error Reset key to continue: 




Note: Because you entered the SEU member type as R when you 
signed on, SEU will provide some RPG syntax checking while you 
enter the statements. The code you are entering in a field is checked 
to make sure it is the correct type of code for that field. So, if you 
enter invalid code, SEU will tell you that you did. 



When you have finished typing the F-specification, press the Enter 
key. Because there is only one F-specification to enter, again press 
the Select Display command key (Cmd 3) and select the l-display 
from the list of displays. 

When the l-display is shown, enter the next statement that defines 
your file: 



16 096 I 
FCUSTNSTRU 




1 096 ^ SEULIB AR230R 
2 DISK 



Wl 



12345 6 78901234 5678 90 \2^' 



6 6 6 iy^M'f 7 8 8 9 

12 34 56 7d 96' mA 567890 1234567890123456 



Enter or update stat«nent number 



34 4 4 4 4 5 5 5' 56 
901 2 3 4567 8901 2 345678 90 



0002 00 



; 



Notice that all the rest of the statements are 1 -specifications that 
define a field. You can use the J -display to enter each statement. 
Again, press the Select Display command key (Cmd 3) and select the 
J-display from the list of displays. 

When the J-display is shown, enter the next statement that defines a 
field: 



16 096 J 

ICUSTMSTR 



Upda te 



1 096 SEULIB 



01 




, .^^^^^^^^^^ 

1 2 3 <i<i'»<i4555 56 666 

123'i5 6 78901234567890125<t567890I23<»567S901 2 3 <t567 890X 2^i4S6;^»^*m 12 S<i 56 

6 67 7 7 8 8 9 
78 90 123'i 567890 123^567890123456 




te statement number 



. . ooirz.oo 



SEU will redisplay the J-display until you select a different display. 
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Continue entering the I -specifications shown in Figure 1 -1 . After you 
have entered all the statements, hold down the Shift key (O) and 
press the Roll Down key (Roll Your display should look like this: 





FCUSTMSTRU 
ICUSTMSTR 



16 096 

0001.00 

0002.00 

0003.00 

0004.00 

0005.00 

0006.00 

0007.00 

0008.00 

oooi 

0010.00 
0011.00 
0012.00 
0013.00 
0014.00 
0015.00 
0016.00 



256 5 I 



01 



096 'StOiii. 
2 ^t%f- 



AR230R 



1 ARCOD 
9 CUSNO 
34 CUSNH 
59 CUSAl 
84 CUSA2 
85 109 CUSA3 
110 111 STATE 
112 1160ZIPCD 
117 1180AREAC 
119 1220PH0NE 

123 123 CUSTP 

124 1270CRLIN 
128 1300SLSN0 
131 1352AM0UE 



Wl 



Enter or update statement number 



Press the Roll Up key (Roil f ) and your display should look like this: 



How to Make Changes to Statements Using 
Enter/Update 

Example 2 

If you make a mistake while entering the statements, don't 
worry-they're easy to fix. 

Just press the Enter/Update command key (Cmd 5). SEU displays a 
prompt at the bottom of the display and places the cursor at the 
prompt so that you can identify which statement you need to correct. 

You can use the roll keys to look at the statements you have entered 
so far and determine the number of the statement you want to change. 

Type in the number of the statement you want to correct (for this 
example, type in 14) and press the Enter key. 



16 096 J 1 096 SEULIB AR230R Wl 

0001.00 FC(fSTHSTiUi 256 5 I 2 DISK 

0002.00 ICUSTMSTR 01 

0003.00 I 11 ARCOD 

0004.00 I 2 9 CUSNO 

0005.00 I 10 34 CUSNM 

0006.00 I 35 59 CUSAl 

0007.00 I 60 84 CUSAZ 

0008.00 I 85 109 CUSA3 

0009.00 i 110 111 STATE 

; OOl«.0d I ■ ■ . ^i^;' - P 112 1160ZIPCD 

0011.00 I P 117 llBOMtEAC 

0012.00 I P 119 1220PH0NE 

0013.00 1 123 123 CUSTP 

0014.00 I P 124 1270CRLIH 

0015.00 I P 128 1300SLSKO 

0016.00 I P 131 1352AHDUE 



Enter or update statement number . . 
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SEU displays the statement for you. Because you signed on to SEU 
with member type R, SEU automatically chooses the J-display. 
Change CRLIM to LIMIT and press the Enter key: 




SEU will store your changes and display the next statement following 
the one you just corrected; in this example, statement 15: 




You could now change statement 15 if you want. Each time you 
press the Enter key, SEU chooses the correct display and displays the 
next statement. 



You can also continue updating statements by pressing the 
Enter/Update command key (Cmd 5), and entering the number of the 
statement you want to change. SEU will display the statement for 
you. 

When you have finished entering the statements, hold down the Shift 
^^ey ( {}) and press the Roll Down key (Roll + ) to view the statements 
you entered. They should look like this: 



16 096 

0001.00 

0002.00 

0003.00 

0004.00 

0005:00 

0006.00 
0007.00 
0008.00 
0009.00 
0010.00 
0011.00 
0012.00 
0013.00 



J 



XUSTMSTRU 
[CUSTMSTR 



01 



256 5 I 



1 096 SEULI8 
1 2 DISK 





1 1 ARCOO 

2 9 CUSNO 
10 34 CUSNM 
35 59 CUSAl 
60 84 CUSA2 
85 109 CUSA3 

110 111 STATE 



' UUIJ.UU 

0014.00 
V 0015.00 
: 0016.00 



Enter, or update statement nvKbVt 
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How to Copy or Move Statements 



You can copy or move statements from one location in a member to 
another location in the same member. You can copy or move one 
statement at a time or a group of statements together. When you copy 
a statement, the statement now exists in both the old and the new 
location within the member. When you move a statement to a new 
location, the statement no longer exists in the old location. 

How to Relocate Statements Using Copy/Move 



Example 3 

Press the Copy/Move command key (Cmd 10-using the 0 key). The 
copy/move prompts are displayed: 




1-18 



Change COPY to MOVE or M on the first line because we only want 
to change the location of the statement, not copy it to another 
location. 

For this example, move statements 4 and 5 to follow statement 7. 
You must enter a location that is between 7 and 8. 

Entering 7.1 as the new location tells SEU to place statements 4 and 5 
after statement 7 but before statement 8. 

Type the responses as shown: 




16 

0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008.00 
0009.00 
0010.00 
0011.00 
0012.00 
0013.00 
0014.00 
0015.00 
0016.00 



P 1 
256 5 r 



01 



096 SEULIB 
2 DISK 



1 
2 

10 
35 
60 
85 
110 
112 
117 
119 
123 
124 
128 
131 



Copy or move the statenents . 

To stateniinit niifbirv.\y"U:< T 
Starting from statement number 
Ending with statement nisNber. 



1 ARCOO 
9 CUSHO 
34 CUSNM 
59 CUSAl 
84 CUSA2 
109 CUSA3 
111 STATE 
1160ZIPCD 
1180AREAC 
1220PH0NE 
123 CUSTP 
1270LIMIT 
1300SLSN0 
13S2AMDUE 



. COPY .HOVE 



HI 




Press the Enter key to enter your responses. 
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SEU will display the first and last statements that are to be moved so 
you can make sure the responses are correct before the statements are 
moved; 



16 " P I -096' SEULIB AR230R 0002 Wl 

0004.00 I 2 9 CUSNO 



1^006.00 I 10 34 CUSNM 

Copy or move the statements ^. . . COPY .MOVE MOVE 

To stateiment number '.• 0007.10 

Starting from statement number . . 0004.00 

Ending with statement number. . . ..... 0005.00 



If the responses are correct, press the Enter key again to actually move 
the statements. If you do not press the Enter key this second time, the 
statements are not moved. 

If you want to change the responses, do not press the Enter key. 
Press the Copy/Move command key (Cmd 10) again and enter new 
responses, or press another command key. 



Note: After you press the Enter key, you can see how the statements 
were moved by holding down the Shift key (O) and pressing the Roll 
Down key (Roll +). The following is displayed: 



16 

0001 .00 

oooz.oo 

0003.00 
0006.00 
0007.00 
0007.10 
0007.11 
OttffiS.OO 
9809.00 

asio.OD 
Qoii.eo 

0012.00 
0013.00 
0014.00 
0015.00 
0016.00 




See How to Insert More than 99 Statements in Chapter 3 for more 
information on moving statements. 
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How to Copy Statements Using Copy/Move 

Example 4 

You can duplicate statements within the member by using copy/move. 

You again use the Copy/Move command key (Cmd 10). If you are 
following the example, the copy/move prompts are already displayed 
for you. For this example, make sure COPY or C is entered for the first 
prompt. 

Type the responses shown: 




CUSTMSTRU 
CUSTMSTR 



01 



1 

5 I 



AR230R 



110 111 STATE 
112 1160ZIPCD 
117 1180AREAC 
119 1220PH0NE 
125 123 CUSTP 
12<« 1270LIMIT 
128 1300SLSNO 
131 1352AM0UE 



Copy or UKM^.'HEIN statMonta COPY, MOVE 

To statMiint 'MlMiber 

Starting froN ctatemant numbar. 
Ending witK st*tamant numbar. . 





To copy statements 6 and 7 and have them follow statement 7.1 1 , you 
must enter a number between 7.1 1 and 8.00, such as 7.12. 

Press the Enter key. 
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SEU displays the first and last statements to be copied so that you can 
make sure your responses are correct: 




To statement number „y. ,; ' 0007.12 

Starting from statement number. . . 'v . . -'i 'i 0006.00 

Ending with statement nuii*er 0007.00 
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If the responses are correct, press the Enter key a second time to 
actually copy the statements. If you do not press the Enter key again, 
the statements are not copied. 

If you want to change your responses, do not press the Enter key. 
Press the Copy/Move command key (Cmd 10) again and enter new 
responses or press another command key. 

Note: After you press the Enter key, you can see how the statements 
are duplicated by holding down the Shift keyCO) and pressing the 
Roll Down key (Roll +) 

The following is displayed: 



16 

0001.00 FCUSTMSTRU 
0002.00 ICUSTMSTR 
0003.00 
0006.00 
0007.00 
0007.10 
0007.11 
0008.00 
0009.00 
0010.00 
0011.00 
0012.00 
0013.00 
0014.00 
0015.00 
0016.00 



Copy or mov* tha statamants 
To statanant numbar .... 
Star-ting from f t«tfli!Mejlc..fflilMbar . 
Ending with Kt''" " 



1 

5 1 



096 SEULI'B 
2 DISK 



AR230R 



1 
35 
60 

Z 
10 



Wl 



1 ARCOD 
59 CUSAl ^ 
84 CUSA2 
9 CUSNO 
34 CUSNN 
85 109 CUSA3 
110 111 STATE 
11? 116DZIPCD 
117 1180AREAC 
119 1220PHONE 

123 123 CUSTP 

124 1270LIMIT 
128 1300SLSNO 
131 1352AHDUE 

COPY, HOVE COPY 




■i -' 



How to Remove Statements Using Delete 



You can remove statements (from a source or procedure member) one 
statement at a time or a group of statements together. 

Example 5 

Press the Delete command key (Cmd 4) and type the responses 
indicated on the following display: 



16 P 1 096 , SlULlI AR230R. Wl 

0001.00 FCUSTMSTRU 256 5 I • C .2 IJISK" • 

0002.00 icusTMSTR oii'tJ-S:': ' 

0003.00 I . V ' ^ , 1 1 ARCOO 

ObOe.dO I \ 35 59 CUSAl 

0007.00 I . ' - 60 84 CUSA2 

0007.10 I , V-.^V'.-^fV; 2 9 CUSNO 

0007.11 I 10 34 CUSNM 

0007.12 I 35 59 OISAI 

0007.13 I 60 84 CUSA2 
0008.00 I , 8^ .1P9 CUSA3 

0009.00 I ' ^.,~':)M:m siAii 

0010.00 I . 112 1160ZIPCD 

0011.00 I ' - P 117 ilSOAREAC 

0012.00 1 P 119 1220PH0NE 

0013.00 I 123 123 CUSTP 

0014.00 I P 124 1270LmiT 



Delete, starting from statement number 

Ending with statement number 



^^^^^^^ 





After you press the Enter key, SEU will display the first and last 
statements to be removed so that you can make sure your responses 
are correct: 
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When deleting only one line, the source text starting from that line is 
displayed at the top of the screen. If the responses are correct, press 
the Enter key a second time to actually remove the statements. If you 
do not press the Enter key ag'a//?, the statements are not removed. 

If you want to change your responses, press the Delete command key 
(Cmd 4) again and enter the new responses. 

If you do not want to remove any statements, press another command 
key. 

Note: After you press the Enter key, you can see where the 
statements were removed by holding down the Shift key ( ) and 
pressing the Roll Down key (Roll The following is displayed: 



16 

0001.00 
0002.00 
0003.00 
0006.00 
0007.00 
0008.00 
0009.00 
0010.00 
0011.00 
0012.00 
0013.00 
0014.00 
0015.00 
0016.00 
0017.00 



FCUSTMSTRU 

ICUSTMSTR 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 



P 1 
256 5 I 



096 SEULIB 
2 DISK 



AR230R 



Wl 



01 





1 


1 ARCOD 




35 


59 CUSAl 




60 


84 CUSA2 




85 


109 CUSA3 




110 


111 STATE 


p 


112 


1160ZIPCD 


p 


117 


IIBOAREAC 


p 


119 


1220PH0NE 




123 


123 CUSTP 


p 


124 


1300SLSNO 


p 


128 


p 


131 


1352AMDUE 


p 


136 


1390DLTPM 



Delete, starting from statement number 
Ending with statement ntimber 



w to End the Job 



When you have finished the work you have to do on the member, you 
can end the job by pressing the End-of-Job command key (Cmd 7). 
The following is displayed: 

. . _ , 

END OF JOB OPTION MENU 
Select one of the following: 




If you do not want to save the sample data, choose option 5 and press 
the Enter key. 
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if you do want to save ail the work you did, choose option 1 and 
press the Enter Icey. The foilowing is displayed: 




END OF JOB 



Mambar nama 

Library nama 

Rafarenca number 

Library member subtype 

2 DTA 13 BAP 16 MNU 19 SRT 33 COB 36 MSU 

11 ARS 14 DFU 17 MSG 31 ASM 34 FOR 40 UNS 

12 ARP 15 FMT 18 PHL 32 BAS 55 RPG 42 BGD 

Remove diagnostics from diagnosed source member? ..... Y,N 



This display allows you to give the member a different name or even 
store it in another library. For this example, leave the responses as 
shown and press the Enter key. The source member named AR230R 
Is stored in the library named SEU LIB. 



See Chapter 2 for more details on the end-of-job options. 



Statement Numbers Are Only Temporary (Renumbering) 

Statement numbers are only temporary-they are not stored as part of 
the statement at end of job. Whether statements are added, deleted, 
or moved during a job, the next time you use the member, all 
statements are numbered in sequential order: 1 .00, 2.00, 3.00, and so 
on. 

For example, assume you have the following statements in a member: 



16 

0001. 
0002. 
0003. 
0004 
0005. 
0006 
0007. 
0008. 
0009. 
0010 
0011 
0012 
0013 
0014 
0015 
0016. 



120 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 




CUSTMASTU 
CUSTMAST 



CUSTAHT U 
CUSTAMT 




,• 1 


1 ARCOO 


-\ . - 35 


59 CUSAl 


60 


84 CUSA2 


85 


109 CUSA3 


110 


111 STATE 


P 112 


1160ZIPCD 


6 DISK 




P 1 


52AMDUE 


6 


13 CUSNO 


14 


38 CUSNM 


. ~ ^ P 39 


420LIHIT, 


//'f- P 43 


472CHGTD; 


' P 117 


n80AREAC 



:^Rter or update statement nunber 



You add the following five statements to the member using the 
A-display: 



'ilT 096 A 



FCUSTMASTU 



' rCUSTMAST 



01 



1 096 SEULIB 



1 .1 ARCOD 
35 59 CUSAl 



Wl 



I 
I 
I 
I 

FCUSTAMT U 
I CUSTAMT 
I 



01 



62 8 I 



60 84 CUSA2 

85 109 CUSA3 

110 111 STATE 

P 112 1160ZIPC0 
6 DISK 

P 1 52AMDUE 



Enter or update statement number 
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The new statements are stored in the member at the end of the job. 
The next time you use that member, the statements will look like this: 



r 



16' 120 Z 1 09^ SEULIB AR233R 

FCUSTHASTU 256 5 L • • laW^'V'- • " 

/nHIS IS THE FIRST STATEMENT' AOQEO '<.. 
/nHIS IS THE SECOND STATEMENT' ADDED 
ICUSTHAST 01 

I . «i..lARCOO 

/*THIS IS THE THIRD STATEMENT ADDED , j.:- 
I "is* 59 CUSAl 

/*THIS IS THE FOURTH STATEMENT ADDED 
/*THIS IS THE FIFTH STATEMENT ADDED 



FCUSTAMT U 

ICUSTAMT 

I 



62 8 I 



01 



0 84 CUSAZ 
5 109 CUSA3 
no 111 STATE 
P 112 1160ZIPCD 
6 DISK 

P 1 52AMDUE 



Enter or update statement nunber 



Don't Worry About Hurting Your Data 



Any of the work you do on a member with SEU is done in a temporary 
work area. 

When you ask for a particular member, SEU gives you a copy of the 
member and keeps the original stored in the library. That means that 
as long as you don't replace it, the original member is protected while 
you make all the changes you want to the copy. 

If you accidentally remove some of the data or change your mind, the 
original is still stored in your library until you specifically tell SEU to 
replace the original with the changed member. 

The member is further protected by SEU, because when you are 
working on the member, no one else can have a copy of it to make 
changes. That way you know that the copy you are using is the latest 
copy of the member. 



Chapter 1. What Is SEU? 



1-31 



If You Need Some Help 



There is a Help key available that will do just that-help you when you 
have a question about what you are doing. If you run into a problem, 
just press the Help key which is located on the left side of your 
keyboard. 

SEU will first display a list of command keys that are available to you 
at that time. Then you should hold down the Shift key ( ), press 
the Roll Up key (Roll +), and SEU will display additional information 
about the ifunction you were using when you pressed the Help key. 

After you've had a chance to look over the help information, press the 
Enter key and you will return to the display you were using so you can 
continue with your job. 

Recovery 

SEU provides a way to recover from error conditions and system 
failures. If an error condition exists, such as the required disk space 
for the work area is not available, or if a system failure such as a 
power failure occurs, you may be able to recover your job from the 
work area. See How to Recover from Interruptions: Planned or 
Unplanned in Chapter 5 for more details. 
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Chapter 2. While Using SEU 



In Chapter 1 you went through some of the general steps involved in 
signing on to SEU, and entering or updating members using SEU. 
Before going any further in using SEU, you may want to know more 
about some of the basic things you've run into so far, such as: 

• SEU parameters- how SEU asks you for information 

• Keys with special assignments 

• The letters and numbers on line 1 of the display 

• How SEU numbers the statements 

• Printing the member 

• What to do at the end of the job. 
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How SEU Asks You For Information 



I V SEU / 1 






□ 








\ , , . 







As you saw in Chapter 1, once you have signed on to the system, the 
easiest way to begin using SEU is to type at the bottom of the display: 

SEU 

The SEU procedure display then asks you to identify the member you 
want to work with and some information about the member. If you 
do not enter at least the member name, SEU will ask for it again- The 
SEU procedure display looks like this: 



SEU PROCEDURE 



Optional-* 



Source entry utility (SEU) is a program that allows you to create, 
change, remove, and locate statentents in source and procedure members 



Name of member to be created or updated 

Type 0* SEU member A.F.P.R.S.T.W S 

Name of member containing SEU formats #SE9XTRA 

Length of statement 

Name of library containing member SEULIB 




Cmd3-Previous menu 



(C) 1983 IBM Corp. 



Name of Member to be Created or Updated 

This names the member to be created or changed. The name can be 
as many as 8 characters long and must begin with an alphabetic 

character (A through Z, #,$, or @). The remaining characters can be 
any combination of characters (numeric, alphabetic, and special) 
except commas (,), apostrophes ('), blanks, question marks (?), 
slashes (/), hyphens (-), or ideographic characters. 

Note: A member name cannot be ALL, DIR, NEW, or SYSTEM. 

If the name you supply is an existing member in the library you 
indicate, SEU assumes that the member is to be updated. If the name 
does not identify an existing member, SEU assumes that the member 
is to be created. 



2-2 



Type of SEU Member 



This specifies the type of the member to be created or changed. 
Type Contents of Member 

A Auto report specifications (syntax checlcing available) 

Note: Although auto report specifications are also 
source, and you could also specify the SEU member type 
as S, it is best to specify member type as A so that syntax 
checking is available. 

Also during update, SEU will select the correct display 
for each statement according to the entry in position 6. 

F Display formats (S- and D-specifications) used by 

$SFGR (SEU will help you select the specification 
displays in their sequential order) 

Also during update, SEU will select the correct display 
for each statement according to the entry in position 6. 

P or PROC Procedure 

R RPG specifications (syntax checking available) 



Note: Although RPG specifications are also source, and 
you could also specify member type as source, it is best 
to specify member type as R so that syntax checking is 
available when you enter RPG specifications. 

Also during update, SEU will select the correct display 
for each statement according to the entry in position 6. 

S or Source statements, such as RPG or auto report 

SOURCE specifications, sort sequence specifications, WSU 

specifications, display specifications, or statements for a 
message source member (syntax checking not available) 

Message translation member (SEU prompts you for 

which message in your message source member you 
want to translate and aids you in entering the translation) 

WSU source statements (SEU selects the WSU 
specification displays for you in sequential order) 



T 
W 



Note: WSU specifications are also source, and you 
could also specify SEU member type as S. If you specify 
SEU member type as W, SEU will help you select the 
specification displays in their sequential order. 

Also during update, SEU will select the correct display 
for each statement according to the entry in position 6. 

Note: If an SEU member type is not entered, SEU assumes the type 
is SOURCE. 
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Name of Member Containing SEU Formats 

This is the name of a load member where the formats for the 
SEU-supplied displays (such as the Z-display) are stored. SEU stores 
all of the displays supplied by IBM in two load members: 
#SE@FORM and #SE@XTRA. 

The SEU-supplied displays guide you as you enter code for your 
source or procedure members. 

The format member name can be up to 8 characters long. If you do 
not enter a format member name, SEU assumes that you are using the 
supplied displays and makes them available to you by entering 
#SE@XTRA for you. 

For information on display formats, refer to SEU-Supplied Displays in 
a Format Member in Chapter 5. 
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Length of Statement 

Statement length is the number of character positions available for the 
type of member specified. It specifies the length of the statements to 
be entered or changed. 

You do not have to enter the statement length. If the member exists, 
SEU uses the current statement length of the member. If the member 
is new, SEU sets the statement length at 96 unless the member type is 
P (120) or T (80). The following chart describes the possible 
statement lengths for each type: 



Member Statement Default 

Type Length Can Be Length 

A 80-96 96 

F 40-120 96 

PorPROC 40-120 120 

R 80-96 96 

S or SOURCE 40-120 96 

T 40-120 80 

W 40-120 96 



Name of Library Containing Member 

This specifies the name of the library that contains the member to be 
changed or that will contain the member to be created. If the library is 
not found, SEU displays an error message. 

A library name is not required. If one is not entered, SEU assumes 
that the member is in the library you are currently using. 

The library name can be as many as 8 characters long and must begin 
with an alphabetic character (A through Z, #, $, or @). The remaining 
characters can be any combination of characters (numeric, alphabetic, 
and special) except commas (,), apostrophes ('), blanks ( ), question 
marks (?), slashes (/), hyphens (-), or ideographic characters. 

Note: Do not use F1, READER, PRINT, or DISK as a library name. 
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After You Have Identified the Member 



Whether you are creating or updating a member, the Z-display is 
always the first display selected by SEU. The Z-dispiay is a free-form 
display and has no fields defined to guide you. 

If you are creating a member, a blank Z-display is shown: 

, 

16 120 Z Enter S 1 096 SEULIB AR230R Wl 




1 2 3 4 5 6 7 

123456789012345678901234S678901234S67890123456789012345678901234567890123456789 




If you are updating a member, the first 16 lines of data are displayed 
in the Z-specification display: 



16 120 

0001.00 

0002.00 

0003.00 

0004.00 

0005.00 

0006.00 

0007.00 

0008.00 

0009.00 

0010.00 

0011.00 

0012.00 

0013.00 

0014.00 

0015.00 



FCUSTMSTRU 

ICOSTMSTR 

I 

1 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 




Enter or update statement number 



EULIB 
DISK 



1 1 

35 59 CUSAl 
60 84 CUSA2 
85 109 CUSA3 
no 111 STATE 
112 1160ZIPC0 
117 1180AREAC 





P 124 1270L1M1T 
P 128 1300SLSN0 
P 131 1352AMDUE 
P 136 1390DLTPM 



2-6 



If there are more than 16 statements in the member, use the roll keys 
to view the rest of the member. 

When you are entering or making changes to the member, SEU 
provides command and function keys to make your job easier. 
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Keys with Special Assignments 

You can select any of the uses of SEU with one of the command keys 
on the top row of the keyboard. Command keys are keys that have 
been assigned special uses. A Keyboard Template, GX21 -7929, 
identifies the name and position of each key. The following 
illustration shows the relationship between the template (which fits in 
the recessed area at the top of the keyboard) and each command key: 




□jpO|Q[D 




Each command key is assigned one of the numeric or special character 
keys in the top row of the keyboard. To select one of the uses shown 
on the bottom row (1 through 12) of the template, press the Cmd 
key and then press the key you want. 

To select one of the uses shown on the top row (13 through 17) of 
the template, press and hold the Shift key ( O ), press the Cmd key, 
then press the top-row key you want. 

Note: Although the command keys and the keyboard template refer 
to keys 1 through 24, the keyboard may not be marked with numbers 
1 through 24. For example, when you are referred to the Copy/Move 
command key (Cmd 10), press the Cmd key and the 0 key. Or when 
you need to use the Accept with Error command key (Cmd 12), press 
the Cmd key and the = key. 
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Command Keys 



To see which command keys are currently available, press the Help 
key and SEU will display a list of keys you may use with the SEU 
function you are using. 

Autoskip (Cmd 1) 

Turns the autoskip option and indicator on and off. When the 
autoskip feature is on (indicated in position 39 of the status line by an 
A), the cursor will skip over all autoskip fields in a statement; data 
cannot be entered into autoskip fields then. This can be used only 
when you are entering or updating. 

More information on autoskip fields can be found under What Type of 
Field Is It? in Chapter 4. More information on the status line can be 
found in this chapter under Line 1 is the Status Line, 

Scan/Replace (Cmd 2) 

Allows you to search through a member for a set of characters 
(sometimes called a global search) and optionally replace that set of 
characters with another set. 

Select Display (Cmd 3) 

Allows you to select a different display by providing a list (or menu) 
of available displays. This can be used only when you are entering, 
updating, or scanning. 

Delete (Cmd 4) 

Allows you to remove a statement or group of statements. 
Enter/Update (Cmd 5) 

Allows you to enter or change statements. 

Print (Cmd 6) 

Turns the print option and print indicator on and off. If the print 
option is on (this is indicated in position 45 of the status line by a P), 
SEU will print any statements you enter, update, delete, or include 
during the job. 

This printout is a record of the changes you have made during the job 
because SEU prints the before and after version of the statements you 
changed. 

This type of printout is different from a printout requested at the end 
of the job. An end of job printout contains only the new version of the 
member. 

More information on alter print can be found later in this chapter 
under Line 1 Is the Status Line. 
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End Of Job (Cmd 7) 



Allows you to choose an end-of-job option. 

Syntax (Cmd 8) 

Turns the syntax checking option and indicator on and off. If this 
option Is on (this is indicated by an S in position 42 of the status 
line), SEU checks RPG II or auto report fields for data that is valid for 
those specification displays. This can be used only when you are 
entering or updating and you have specif ied the SEU member type as 
RorA. 

Search End of Source (Cmd 9) 

Displays the last statement in the member. 

Copy/Move (Cmd 10) 

Allows you to copy (duplicate) statements into another location 
within the member or move (change the location of) statements in the 
member. 

Include (Cmd 11) 

Allows you to copy statements from an existing member to the 
member you are entering or updating. 

You cannot include statements you just entered during the current job. 

Accept with Error (Cmd 12) 

Allows you to place a statement with a syntax error into a member. 
There may be times when you need to place statements in a member 
even though they contain syntax errors. Maybe you're rushed for time 
or maybe you need to get someone to help you correct the errors. 

Accept with error is allowed only if the syntax checking option is on 
(indicated by an S in position 42 of the status line) and an error exists 
in an RPG II or auto report statement. This can be used only when 
you are entering or updating and the member type is A or R. 

How to record syntax errors: To create a printed record of each 
statement accepted with an error, along with the text of the 
appropriate SEU diagnostic message printed beneath the statement, 
check position 45 of the status line. If P is not there, the print option 
is off. Turn the print option on with the Print command key (Cmd 6) 
before you press the Accept with Error command key (Cmd 12). 

After you end an SEU job during which syntax errors were accepted, 
you can use the printed list of statements to help you correct any 
syntax errors you didn't correct during the job. 

See Uti/ities Messages for more information on messages. 
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Command Key Display (Cmd 13) 



Displays a list of the SEU command keys and describes each key. 

Scan to Update (Cmd 14) 

When SEU has located the scanned-for characters in a statement, scan 
to update will display the statement in enter/update so you can make 
changes if you want, if the scanned-for characters are not found, or 
an error occurs, SEU redisplays the scan prompts. This can be used 
only when you are entering, updating, or scanning. 

Change Roll Factor (Cmd 15) 

Allows you to change the number of new statements (this is indicated 
in positions 2 and 3 of the status line) that are displayed if a roll key is 
pressed. This (Change Roll Factor (Cmd 15)) is not allowed when 
you are translating messages. 

Lines Per Stmt (Cmd 16) 

Allows you to reverse the number of lines (this is indicated in position 
42 of the status line) used to display each statement from 1 to 2 or 2 
to 1 . This is not allowed when you are translating messages, or 
displaying a single statement. 

Translate (Cmd 17) 

Allows you to translate each message in your message source member 
into a second language. 
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Function Keys 



All the function keys are described in the operator's guide for your 
display station. However, some of the function keys have special uses 
in SEU jobs and are described below. 

Home 



The Home key acts as a record backspace key. It can be used only 
when you are entering or updating. 

When you press this key, the cursor is moved back to the first cursor 
position in a statement where you can enter data (defined by the 
display), if the cursor is already in the first position for a statement, 
the preceding statement is displayed. 



The Dup key can be used two ways, depending on whether you are 
entering or changing statements. If you are entering data, the Dup key 
will duplicate data for you from the previous statement. If you are 
changing data, the Dup key will not duplicate data for you; instead, it 
allows you to cancel changes you were typing within a field. 

Using the Dup key while entering data: The Dup key duplicates, 
or copies, all or part of a field from the preceding statement into the 
statement you are currently entering. 

For example, assume you are entering the statements in this 
procedure: 



16 120 Z 

0001.00 

0002.00 

0003.00 

0004.00 



1 120 SEULIB 0E400R Wl 



Enter or update statement 
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Statements 2 and 3 are similar. After you enter statement 2, you are 
prompted to enter statement 3: 



X6 120 Z Enter 1 120 SEULIB 0E4G0R HI 




1234567890123456789012345678901234567890123456789012345678901234567890123456789 



8 9 0 ' ' I - , -/.Z-, 

01234567890123456789012345678901234567890 




Rather than typing statement 3, if you are not in ideographic mode, 
press the Dup key. The code you entered in the first field of statement 
2 is copied to the first field of statement 3. Overscored asterisks (*) 
are displayed in the positions of the first field of statement 3 that will 
contain the code copied from the previous statement: 








0E400R 


W2 



16 096 Z Enter 
// FILE NAME-CUSTMAST -v.,^ „ 

' ■ ■ 'M 

1 2 3' ■•.••••:4' • . 5 ■ 6;. ' ... 1 

123456789gi2345678?gi2345678?01^ ' 

8 9 0 1 2 

01234567890123456789012345678901234567890 




Enter or update statement number ... 0003.00 



The duplicated code is actually entered when you press the Enter key 
to enter the entire third statement. 
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Press the Home key and the code in statement 3 is displayed for you. 
Move the cursor to position 14 and type the new file name, 
CUSTORDS, Press the Enter key to enter the change: 




If you press the Dup key when the cursor is at the beginning of a 
field, SEU fills the field with data from that corresponding field in the 
previous statement. If you press the DUP key when the cursor is not 
at the beginning of a field, SEU fills the cursor position and the rest of 
the field with data from corresponding positions in the previous 
statement. 

If you press the Dup key when you are entering the first statement in a 
member, SEU fills the field with blanks because there is no preceding 
data. 

Using the Dup key while updating data: When you are updating 
a field within a statement and press the Dup key, it does not duplicate 
data from the preceding statement. If you have typed incorrect data 
into a field, move the cursor back to the beginning of the field and 
press the Dup key. SEU restores the original data to the field. 



This key displays additional information, if any, about the display you 
are using. If there is more than one field on the display, the help text 
displayed will explain the field the cursor was in when you pressed 
the Help key. 

For example, assume you are using this display: 



16 

0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008 00 
0009.00 
0010,00 
0011.00 
0012.00 
0013.00 
0014.00 
0015.00 



FCUSTMSTRU 

ICUSTMSTR 

I 

I 

I 

I 

I 

I 

r 
I 
I 
I 



01 




B AR230R 



HI 



Include from library nane . . 
Include from member name. . . 
Including at statement number 



1 


1 ARCOO 


35 


59 CUSAl 


60 


84 CUSA2 


85 


109 CUSA3 


110 


111 STATE 


112 


1160ZIPC0 


117 


1180AREAC 


119 


1220PH0NE 


123 


123 CUSTP 


124 


1270LIMIT 


128 


1300SLSN0 


131 


1352AM>UE 


136 


1390DLTPM 




. SEULI8 
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When you press the Help key, SEU displays a list of available 
command keys. Press the Roll Up (Roll +) key and the following 
additional information is displayed: 



HELP 



Include from library name 



Enter the name of- the 'library; %h$t ct^k^^^U^^^g^l^S^ which 
you want to include one or more statei^^^^^^^i^^;: , ■ 
If you have not specified a library, th^i^^^^|LIBRARY , the 
system library. If you entered // ilWl^S0^1m^i^rmWi»d6 earlier, the 
default library Is libname. If you spec'IfUd a library In the last 
parameter of the SEU command, that library is the default library. 



Include from member name 



The Included member automatically defaults to the member type of the 
member you are including into. If you want the incTUded member to be 
of a different type, enter: NAME, TYPE where NAME is the member name 
and TYPE is P for procedure member or S for source member. 



Enter-Exit help text 



Roll keys-Page4 



You can use the Roll Up key (Roll + ) to continue the help text if 
there is more than one help display for the display you were using. 

Roll Up (Roll f ) 

When you hold down the Shift key (O) and press the Roll Up key 
(Roll f), SEU will display statements that are closer to the end of the 
member than those currently on the display. The statements appear to 
roil upward and out of sight at the top of the display. 

If you continue to hold down the Roll Up key and the Shift key {{}), 
SEU will continue to roll through the member. This allows you to 
look through the member in a short time. 

The roll factor determines how many new statements are displayed 
when you press a roll key. Assume that the roll factor is 1 2. If 
statements 1 .00 through 1 6.00 are being displayed when you press 
the Roll Up key, SEU displays 12 more statements, or statements 
13.00 through 28.00. 

Positions 2 and 3 of the SEU status line show the current roll factor. 
You can change the roll factor by pressing the Change Roll Factor 
command key (Cmd 1 5) and entering a new factor. The roll factor 
can be any value from 1 through 99. 

Wraparound: Wraparound occurs when you press the Roll Up key 
(Roll + ) after SEU displays the last statement in the member. If the 
last statement is being displayed when you press the Roll Up key, SEU 
starts over again and displays the first and following statements in the 
member. 

For example, assume the member contains 43 statements and the roll 
factor is 16. If statements 25.00 through 40.00 are being displayed 
when you press the Roll Up key, SEU displays statements 41 .00 
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through 43.00. If you press the Roll Up key again, SEU displays 
statements 1 .00 through 16.00. 



Roll Down (Roll ^) 



The Roll Down key operates the opposite of the Roll Up key (Roll + ). 
It causes SEU to display statements that are closer to the beginning of 
the member than those currently on the display screen. 

The statements appear to roll downward from the top of the display 
when you press the Roll Down key with the shift key. 

Wraparound: Wraparound occurs when you press the Roll Down 
key after SEU displays the first statement in the member. If the first 
statement is being displayed when you press the Roll Down key, SEU 
goes to the end of the member and displays the last and preceding 
statements. 



Using the Roll Keys 



When using the roll keys, think of the records in the file as being on 
the outside surface of a drum or cylinder. As the drum is rolled 
forward or back you can view a specific part of the file. 




cccccccccccccccccccccccc 



Cfffffffffffffffffffffff 

GGQGGS QGG G GGQGGOO 'j-^CA/ -''G 

iiiiilBiiiiliiiiiiiBil^ 

illllillilliiliig 



1 

>1 'Roll 



cccccccccccdccctccctccc 



EEEEEEEEEEEEEEEEEEEEEEE 
FFFFFFFFFFFFFFFFFFFFFFF 
GSGGGGGGGGGGGGGGGGGGGGG 
HHHHHNHHHHHHHHHHHHHHHHH 

iiiiiniurinunmii 



Roll 

I Up 

\ Roll 

\ 

\ 

\ 

\ 
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Cursor Movement Keys 



Field Exit 



Field + 



The Field Exit key moves the cursor out of an input field. When you 
press this key in a field defined as blank fill, blanks are inserted from 
the cursor position to the end of the field. When you press Field Exit 
in a field defined as zero fill, the data is right-adjusted (shifted to the 
rightmost position of the field) and any remaining positions are filled 
with zeros instead of blanks. 

Because of this, the Field Exit key should be used carefully so you do 
not blank out data when making changes to a field. 



The Field + key moves you out of an input field the same as the Field 
Exit key. It can also insert a plus (+) sign in the last position of a 
signed numeric fiejd. Because of this, the Field + key should be used 
carefully so you do not blank out data when making changes to a 
field. 



Field Advance 



This key moves the cursor forward to the next available field without 
right adjusting any data within the field. 



Field Backspace 



This key moves the cursor back to start of this field, or, if already 
there, then to the start of the previous field. 



New Line Key 



B 



This key moves the cursor to the next line of the display. 
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Line 1 is the Status Line 



Line 1 of the display is called the status line and contains general 
information about your job. The following is an example of a status 
line and what it can contain: 




Autoskip Option 



Length of 
Input Fields 

Name 
of the 
SEU 
Display 



f— I- 



Enter or 
Update 



Syntax Check Option 
Print Option 

Number of Lines 
per Statement 

Statement 
Length 

Library 

Name 




Name of Member 
Being Processed 

Number of Consecutive 
Statements 

Display Station ID 

—hi- 




12345678901 



,-"8" 9 0 I 

01234567890123456789012345678' 



Enter or update statement nunbt 



0001.00 



The Roll Factor is in positions 2 and 3. it determines how many 
new statements are displayed if the Roll Up (Roll t ) or Roll Down 
(Roll i ) function key is pressed. 

The roll factor is always 16 immediately after SEU sign-on. To change 
the factor to any value from 1 through 99, press the Change Roll 
Factor command key (Cmd 15). For more information on changing 
the roll factor, see Command Keys earlier in this chapter. For more 
detail on the roll keys, see Function Keys earlier in this chapter. 

The Length of Input Fields in positions 7 through 9 is the number 
of character positions available for the type of display you are using. 
This number may differ from the member statement length (which is 
determined by the type of member) specified in positions 46 through 
48. 

The Name of the SEU Display being used in enter/update is in 
positions 1 3 through 23. 

Enter or Update in positions 24 through 29 indicates whether you 
are entering or updating statements. 
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The Autoskip Option is shown in position 33: A if the option is on, 
blank if the option is off. The autoskip option is always off at the 
beginning of an SEU job. The option is changed each time you press 
the Autoskip command key (Cmd 1). If the option is on when you 
enter or change a statement, SEU automatically skips fields in the 
statement that are defined as autoskip fields by the format of the 
display. For more information, see Autoskip Fields in Chapter 4. 

The Syntax Check Option is shown in position 36: S if the option 
is on, blank if the option is off. Syntax checking means that SEU will 
check the RPG or auto report fields to make sure the data you entered 
is valid for those formats. 

If the member type is A (auto report) or R (RPG), the syntax checking 
option is on at the beginning of the SEU job and changed each time 
you press the Syntax command key (Cmd 8). If the member type Is S 
(source) or P (procedure), the option is off at the beginning of the job 
and cannot be turned on during the job. 

The Print Option is shown in position 39: P if the option is on, 
blank if the option is off. If the print option is on, SEU prints the 
statement when you enter, update, delete, or include a statement. 

The print option is always off at the beginning of a job. To change 
the print option, press the Print command key (Cmd 6). SEU printing 
is described in more detail in What About a Printer later in this 
chapter. 

The Number of Lines per Statement is in position 42. The status 
of this option is indicated by a 1 or a 2. When you are viewing a 
member, SEU displays each statement on either one or two lines of 
the display. If one line is reserved for each statement SEU displays 
only the first 70 characters of the statement and displays a maximum 
of 1 6 statements at a time. If two lines are reserved for each 
statement, SEU displays the entire statement and displays a maximum 
of eight statements at a time. 

At SEU sign-on, one display line is reserved for each statement. You 
can change the number of display lines per statement by pressing the 
Lines Per Statement command key (Cmd 16). 

The Statement Length for the display is in positions 46 through 48. 
This is the number of character positions available for the type of 
member you specified at sign-on. It specifies how long the 
statements can be. This number may differ from the number of 
character positions (which is determined by the type of display) 
shown in positions 7 through 10. 

The Library Name identifies the library where the member you are 
using is stored. The library name is in positions 52 through 59. 

The Name of Member Being Processed is in positions 63 through 
68. Tliis identifies the member you are using. 

The Number of Consecutive Statements being deleted, moved, or 
included at one time is in positions 73 through 76. This is displayed 
only when you are deleting, moving, or including statements. 

The Display Station ID identifies which display station you are 
using (for example, W1 or W2). The display station is identified in 
positions 79 and 80. 



Statement Numbering 



You may have noticed the numbers to the left of each statement. SEU 
assigns each statement in a member a unique statement number. 
Statement numbers allow you to identify statements you want to 
enter, change, delete, move, or include. 

The statement number assigned by SEU during the job is only 
temporary- it is not stored as part of the statement. 

How Statements Are Numbered 

The form of the statement number is xxxx.xx. However, the following 
numbers are all equal to statement number 5: 5, 5.0, 5.00, and 
0005.00. 

When you are using an existing member, the first statement in the 
member is assigned number 1 .00, the second 2.00, the third 3.00, and 
so on, to a maximum of 9999.00. If you try to enter more than 9999 
statements, SEU displays an error message. If the SEU print option is 
on, SEU prints the statement you entered but does not store the 
statement in the member. 

Adding Statements to a Member 

You can add statements at the end of a member. You must assign a 
number to the first added statement; after that SEU assigns the 
numbers automatically. 

If you want to enter a statement number higher than the highest 
statement number in the member, the new statement number cannot 
be greater than 1 .99 higher than the last whole number. 

For example, if the highest statement number in the member Is 
0004.00, a new statement number can be any number from 0004.01 
through 0005.99. If the highest statement number is 0006.98, a new 
statement number can be any number from 0006.99 through 0007.99 
(adding 1.99 to 6.00). 

When you assign the first new statement number: 

• If you enter a whole statement number (for example, you enter a 
new statement number of 5), SEU assigns whole statement 
numbers to the following statements (for example, statement 
numbers 6.00, 7.00, and so on). 

• If you enter a number with decimal positions (for example, you 
enter a new statement number of 5.1 or 5.10), SEU assigns 
statement numbers to the following statements that are increased 
by .01 (for example, statement numbers 5.1 1 , 5.1 2, 5.1 3, and so 
on). 
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Inserting Statements 



You can insert any number of statements up to 99 statements between 
any two whole numbered statements in a member. For example, 
assume you have several statements numbered 1 .00, 2.00, and so on. 
Press the Enter/Update command key (Cmd 5). When SEU asks you 
which statement you want, enter 1 .1 . SEU displays a blank statement 
display so that you can enter a new statement. 

Enter the statement. 

SEU will place the new statement between statements 1 .00 and 2.00 
and display another blank statement display numbered 1.11. 

If you continue to insert new statements in the same place, SEU will 
automatically assign each statement number by adding .01 to the 
previous statement number. 

How to Find a Statement in a Large l\/l ember 

When you are using a member with many statements, it is 
time-consuming to roll through the member to locate a particular 
statement. Instead, if you know the number of a statement you want 
displayed, select enter/update and enter the number in response to the 
enter/update prompt on the bottom of the display. If you do not 
know the statement number, use one of the following two methods to 
find the statement: 

• Using enter/update, enter a statement number you think is close to 
the one you want, then use the Roll Up or Roll Down key to 

locate the statement. 

• If you know that the statement contains unique characters, such 
as a file name in an RPG 11 F-specification, you can use scan to 
locate the characters. Enter the unique characters in response to 
the scan prompt Scan characters. 

If the first statement located by scan is not the statement you are 
looking for, repeat the scan by pressing the Enter key or the Scan to 
Update command key (Cmd 14). 
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What About a Printer 



SEU does not require a printer for sign-on. But SEU expects a printer 
to be available if: 

• The print option is on during your job when you enter, update, 
delete, or include a statement. 

• You request a printout at the end of your job with end-of-job 
option 2 or 4. 

If no printer is available when one is needed, SEU displays an error 
message. See the System Reference manual for more information on 
the PRINT procedure, which allows you to do such things as assign 
the printer, set the number of characters per inch, and so on. 

If spooling is not active, if the print option is on during the job, and a 
printer is available and running, your statements will print out as you 
enter or update them. If spooling is active and the print option is on, 
the statements you enter or update will be printed out at the end of 
the job and reflect the changes you made. 

See the manual Concepts and Programmer's Guide for more 
Information on spooling. 

Note: A listing requested as an end-of-job option prints the updated 
version of the member, but does not note the changes you made 
during the job. Records that are printed as a result of your having the 
Print option on during the job are printed individually and changes 
you made are noted. 

For information on the various ways to print out your source, refer to 
Printing Your Jobs in the manual Operating Your Computer. 
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Printing a Member 

On all SEU end-of-job printouts, the first printed line of the first page 
contains the program date for the SEU Job, the time of day when you 
requested the print, and a label that identifies it as an end-of-job 
printout. Printouts requested at end of Job also contain the member 
name and library name on the first printed line. 



MEMBER AR230R LIBRARY SEULIB SEU EOJ PRINTOUT DATE 12/l<&/82 TIME 14. 40 

IBM SYSTEM/36 SOURCE ENTRY UTILITY 



FCUSTMSTRU 2S5A SI 2 DISK 

ICUSTMSTR 01 



I 






1 


1 ARCOD 


I 






35 


59 CUSAl 


I 






60 


84 CUSA2 


I 






&S 


109 CUSA3 


I 






110 


111 STATE 


I 




P 


112 


11 602 I PCD 


I 




P 


117 


11 80 ARE AC 


I 




P 


119 


1220PH0NE 


I 








123 CUSTP 


I 




P 


124 


1270LIMIT 


I 




P 


128 


1300SLSN0 


I 




P 


131 


13S2AMDUE 


I 




P 


136 


1390DLTPM 




I 


C N D OF S E 


: U 


PRINTOUT 



Note: Because SEU begins printing on the sixth line of the paper, 
the designated page size must be greater than six lines. Refer to the 
System Reference manual for more information on the SET command, 
which changes the number of print lines. 
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End of Job 

When you press the End of Job command key (Cmd 7), SEU displays 
a list of options. 

Source Members at End of Job 



If you are creating or updating a source member, SEU displays the 
following end-of-job options: 




End-of-Job Options 

0 Return to processing: The job continues as though the End of 
Job command key (Cmd 7) had not been pressed. The cursor is 
returned to the first cursor position defined by the specification 
display. Option 0 is not allowed if the SEU work file is full or if an 
error exists for the display station. 

1 End of job with no additional options: SEU copies the 
member from the work area to a library and replaces the old member 
in the library. 

2 End of job with a printout: SEU copies the member from the 
work area to a library, replaces the old member, and then prints the 
new member on the printer currently assigned to the display station. 

3 End of job with seriah'zation: Serialization means that a 
four-digit serial number is inserted into each of the statements starting 
at a position you specify. (If you choose this option, you are 
prompted for the serialization start position on a following display.) 

Be sure these positions do not already contain data in each statement, 
because SEU will store the serial number over whatever data exists in 
those positions. 

4 End of job with serialization and a printout: This is a 
combination of options 2 and 3. The member is serialized, copied 
from the work area to a library, and listed on a printer. 
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5 End of job--member is not replaced: SEU ends the job by 
removing the data in the work area. AM new or changed data entered 
during the job is lost. If you were updating an existing member, this 
option cancels the update, and the member in the library remains 
unchanged. 



End-of-Job Maintenance 



If you choose end-of-job option 1 or 2, SEU gives you a chance to do 
several things, such as: 

• rename the member as a new member 

• store it in another library 

• assign it a reference number 

• assign it a subtype 

• remove diagnostics. 

If you choose end-of-job option 3 or 4, SEU asks you for some 
additional information: 

• the start position for serialization 

• if you want the program name duplicated in positions 75 through 
80. 

The following is displayed: 



END OF JOB 



Member name ARZ^ORi, 

Library name SEULIB 

Reference number OOOOPZ 

Library mefflbar subtype ^5- : 

2 DTA IS BAP 16 MNU 19 SRT 33 COB 36 WSU ^3 BGF 

11 ARS 14 DFU 17 MSG 31 ASH 3<i FOR ^0 UNS 

12 ARP 15 FMT 18 PHL 32 BAS 35 RPG 1Z BGD 

Renove diagnostics from diagnosed source member? Y,N N 




Start serialization at position: This prompt is displayed only if 
you select end-of-job option 3 or 4. The number specifies the 
position where the serial number will begin in each statement. The 
response can be any number greater than 0 that is equal to or less 
than statement length minus 3. SEU will overlay any data that is in 
these positions. 
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SEU supplies a value of 1 for this prompt but you may change the 
value. 

If you are using RPG II or auto report statements and the member 
contains compile-time tables, you should specify a serial start position 
of 1 . Serialization stops if SEU finds two asterisks and a blank in the 
first three positions (indicating compile-time tables), and if you 
specify a serial start position of 1 . 

After you enter a response, SEU serializes statements in the member 
with four-digit numbers beginning with 0001 . 

Member nanne: SEU supplies the name you specified at the 
beginning of the job for this prompt. You can change the name. If 
you were updating an existing member, you can now store the 
changed member under a new name and save the original member as 
it was. 

Library name: SEU supplies the name of the library you specified at 
the beginning of the job for this prompt. You may change the name 
and store the member in a different library. If you are using an 
existing member, a copy of the new member is stored in the new 
library, and the old member remains in the original library. 

Reference number: This is a number SEU assigns to the member 
and stores in the library directory. If you are creating a new member, 
SEU supplies 000001 as the response and increases the number by 
one at the end of every SEU job that uses that member. You may 
change this number. You may use the reference number to keep track 
of the number of updates to the member, or the latest LISTLIBR 
printout. 

Library member subtype: You may assign a subtype for a source 
member at end of job. A subtype further identifies a member within 
its type in a library listing. 

For example, the LISTLIBR procedure may list and identify all of the 
members in your library as source (type S), procedure (type P), object 
(type 0), or subroutine (type R) members. Although several members 
may be source, DFU source is very different from assembler source or 
FORTRAN source, and so on. 

By assigning a subtype at end of job, you can identify a member such 
as a DFU source member or a FORTRAN source member. 

If you do not enter a subtype for a new member, the subtype is 
entered as unspecified (40 UNS). 

If you do not enter a subtype for an existing member, the subtype 
remains as the subtype that was specified when the member was last 
stored. 

Note: Some SEU member types have default subtypes. For example, 
if you specified an SEU member type of W (WSU), a subtype 36 is 
specified for you. 

The following subtypes are available for source or procedure members: 

2 DTA Data member 

1 1 ARS Automatic response member 

12 ARP RPG Auto report member 

13 BAP BASIC procedure (source member) 
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14 


DFU 


Data file utility member 


15 


FMT 


Display format member 


16 


MNU 


Menu member 


17 


MSG 


Message member 


18 


PHL 


Phone list member 


19 


SRT 


Sort member 


31 


ASM 


Assembler member 


32 


BAS 


BASIC member 


33 


COB 


COBOL member 


34 


FOR 


FORTRAN member 


35 


RPG 


RPG member 


36 


wsu 


Work station utility member 


40 


UNS 


Unspecified 


42 


BCD 


Business Graphics Data 


43 


BGF 


Business Graphics Format 



Remove diagnostics from diagnosed source member?: While 
you are compiling a source member, the compiler can create a 
diagnosed source file that contains the source statements along with 
the diagnostic and informational messages from the compilation. SEU 
uses that file as input and allows you to make changes. If you enter a 
Y for this prompt, SEU will omit all the diagnostic and informational 
messages from the member when you have finished correcting the 
member. Refer to SEU Procedure Command in Chapter 5 for more 
information on SEU-diagnosed source files. 

Note: For more information on compiling a source member and 
diagnosed source files, see the related programming reference manual. 

Duplicate program name (in positions 75 through 80): This 
prompt is displayed only if you specified an SEU member type of A, R, 
or S when you signed on to SEU; if you have selected option 3 or 4 of 
the end -of -job options; and if the statement length specified is 80 or 
greater. 

If you enter Y, SEU copies the value in positions 75 through 80 of the 
first statement into positions 75 through 80 in each of the remaining 
statements in the member. SEU will copy the value over serial 
numbers, comments, or code, if they exist in positions 75 through 80. 
If a source member contains compile-time data and program name 
duplication is requested, a serial start position of 1 should be specified 
to prevent the serial number from being overlaid by the program name. 

If serialization is being done in positions 1 through 4 and two 
asterisks and a blank are found in positions 1 through 3, which 
indicates the presence of compile time data, program name duplication 
and serialization are discontinued. 

If you enter N, SEU does not copy the value contained in positions 75 
through 80 of the first statement in the member. 

If you enter any value other than Y or N, SEU displays an error 
message and redisplays the prompt. 



Procedure Members at End of Job 



if you are creating or updating a procedure member, SEU displays the 
following end-of-job options: 



END OF JOB OPTION MENU 
Select one of the following: 




Specify the option you want. . . . 



End-of-Job Options 

0 Return to processing: The job continues as though the End of 
Job command key (Cmd 7) had not been pressed. The cursor is 
returned to the first cursor position defined by the display. Option 0 is 
not allowed if the SEU work file is full or if an error exists for the 
display station. 

1 End of job with no additional options: SEU copies the 
member from the work area to a library and replaces the old member 
in the library. 

2 End of job with a printout: SEU copies the member from the 
work area to a library, replaces the old member, and then prints the 
new member on the printer currently assigned to the display station. 

5 End of job--member is not replaced: SEU ends the job by 
removing the data in the work area. All new or changed data entered 
during the job is lost. If you were updating an existing member, this 
option cancels the update and the member remains in the library 
unchanged. 
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End-of-Job Maintenance 

If you choose end-of-job option 1 or 2, SEU gives you a chance to do 
several things, such as: 

• identifying program data in statements 

• renaming the member 

• storing the member in another library 

• assigning the member a subtype and reference number. 
The following is displayed: 




If the SEU job that is ending did not create the procedure, but only 
updated it, SEU displays the current status of the options in the 
response positions. You may change the options. 

Program data in include statements?: Procedure commands that 
run SRT (single requester terminal) programs may contain program 
data instead of parameters. Procedure commands that run MRT 

(multiple requester terminal) procedures always contain data instead 
of parameters. If the procedure command contains program data 
instead of parameters, you must enter a Y. (Y for this prompt is the 
same as PDATA-YES for the $MAINT library maintenance utility 
program.) If the procedure command does not contain program data, 
the response must be N for no. The default value for a new member is 
N. Procedure commands and $MAINT are described in the System 
Reference manual. 

Member name: SEU supplies the name you specified at the 
beginning of the job for this prompt. You can change the name. If 
you were updating an existing member, you can now store the 
changed member under a new name and save the original member as 
it was. 
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Library name: SEU supplies the name of the library you specified at 
the beginning of the job for this prompt. You can change the library 
name and store the member in a different library. 

Reference number: This is a number SEU assigns to the member 
and stores in the library directory. If you are creating a new member, 
SEU supplies 000001 as the response and increases the number by 
one at the end of every SEU job that uses that member. You can 
change this number. You can use the reference number to keep track 
of the number of updates to the member, or identify the latest 
LISTLIBR printout. 

Library member subtype: You may assign a subtype for a 
procedure member at end of job. A subtype further identifies a 
member within its type in a library listing. 

For example, the LISTLIBR procedure can list and identify all of the 
members in your library as source (type S), procedure (type P), object 
(type O), or subroutine (type R) members. Although several members 
may be procedure members, a sort procedure is different from an 
assembler procedure or a COBOL procedure. 

By assigning a subtype at end of job you may identify on the 
LISTLIBR printout a member as a sort procedure, a COBOL procedure, 
or whatever. 

If you do not enter a subtype for a new member, the subtype is 
entered as unspecified (40 UNS). If you do not enter a subtype for an 
existing member, the subtype remains as the subtype that was 
specified when the member was last stored. 

The following subtypes are available for source or procedure members: 



2 


DTA 


Data member 


11 


ARS 


Automatic response member 


12 


ARP 


RPG Auto report member 


13 


BAP 


BASIC procedure (source member) 


14 


DFU 


Data file utility member 


15 


FMT 


Display format member 


16 


MNU 


Menu member 


17 


MSG 


Message member 


18 


PHL 


Phone list member 


19 


SRT 


Sort member 


31 


ASM 


Assembler member 


32 


BAS 


BASIC member 


33 


COB 


COBOL member 


34 


FOR 


FORTRAN member 


35 


RPG 


RPG member 


36 


WSU 


Work station utility member 


40 


UNS 


Unspecified 


42 


BCD 


Business Graphics Data 


43 


BGF 


Business Graphics Format 
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Log the procedure statements?: If you want the system to log the 
procedure statements to the system history file each time the 
procedure is called, the response must be Y for yes. If you do not 
want the procedure statements logged, the response must be N 
(which is recommended). The default when using a new member is 
Y. 

Multiple requester terminal procedure?: If the procedure is an 
MRT (multiple requester terminal) procedure, the response must be Y 
for yes. If the procedure is not an MRT procedure, the response must 
be N for no. The default for a new member is N. If you are updating 
an existing member, SEU displays the responses to the prompts as 
they were last stored. 

For a description of multiple requester terminal procedures, see the 
Concepts and Programmer's Guide. 



Chapter 3. Using SEU 



Chapter 1 introduced using SEU: enter/update, delete, and 
copy/move. The following sections give more details about the uses 
of SEU and include examples of using scan/replace, include, and 
message translate. 

One sample source member will be used throughout the chapter. 
Assume the following statements are in a source member called 
AR230R. 

Note: Changes were made to this member in Chapter 1 examples. 





Filename 

7 8 9 ' 10 II 12 13 14 


File Type 


Mode of Processing 


1 Extension Code E/L | 


Device 

40 41 42 43 44 45 46 


Symbolic 
Device 

47 48 49 50 51 52 


Labels S/N/E/M | 


Name of 
Label Exit 


Extent Exit 
for DAM 


File Addition/Unordered 


r 




|3 l/O/U/C/D 


File Dnignation 




Length of Key Field or 
of Record Address Field 


D 

5 

66 


Number of Tracks 


Line 
3 4 5 


|<» Form Type 


o 

o 
a; 
16 




for Cylinder Overflow 


17 






Record Address Type 


67 


Number of Extents 


O 

< 

IS 


Sequence 

File Format 


1 A/P/l/K 


Type of File 
^ Organization or 


Storage Index 


68 69 


Tape 
Rewind 


Q 
S 

> 

IT 


Block 
Length 


Record 
Length 


1 I/X/D/T/R/ c 


Moaiiionai Area 
Overflow Indicator 


z 

5 

70 


File 

Condition 




Key Field 

Starting 

Location 


Continuation Lines 


UC 

71 72 


73 74 


K 
53 


Option 
54 55 56 57 58 59 


Entry 
60 61 62 63 64 65 


External Record Name 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 


39 


0 


2 




F 


c 


u 


s 


T 


M 


S 


T 


R 


u 




















z 


5 


6 






5 




I 










2 




D 


I 


S 


K 
































































0 


3 




F 









































































































































T 


Filename 
or 

Record Name 


Sequence 


Number (1/N), E 1 


S Option (01, U,S 1 


<o Record Identifying Indicator, 
1 8 **, or DS 


External Field Name 


1 S Stacker Select | 


1 6 P/B/L/R 1 


Field Location 


1 S Decimal Positions 1 


RPG 
Field Name 

53 54 55 56 67 58 


^ Control Level (L1L9) 


2 Matching Fields or 
g Chaining Fields 


g Field Record Relation 


Field 
Indicators 


71 72 73 74 


Line 

3 4 5 


<» Form Type 


Record Identification Codes 


1 


2 


3 


From 


To 


Plus 

65 66 


Minus 
67 68 


Zero 
Blank 

69 70 


Position 
21 22 23 24 


Z 

o 
z 

25 


O 
N 
O 

26 


j S Character 


Position 

28 29 30 31 


2 
Z 

32 


a 
o 

33 


1 g Character 


Position 
35 36 37 38 


Z 

z 

39 


1 § C/Z/D 


1 ^ Character 


Data St 


ructure 


Data 
Structure 
Name 
7 8 9 10 11 12 


13 


0 
A 
14 


R 
N 
15 


D 
16 


Occurs 

44 46 4(j 47 


Length 
48 49 50 51 


0 


1 






c 


u 


s 


T 


M 


S 


T 


R 










0 


1 














































































































0 


2 






















































































1 








1 




A 


R 


C 


0 


D 




































0 


3 






















































































5 






5 






C 


U 


S 


A 


1 




































0 


4 




















































































6 


0 






8 


H 




C 


a 


s 


A 


2 




































0 


5 




















































































8 


5 




1 


0 






C 


U 


s 


A 


3 




































0 


6 


















































































1 


1 


0 




1 


1 


1 




s 


T 


A 


T 


E 




































0 


7 














































































P 




1 


1 


2 




1 


1 




0 


z 


I 


P 


C 


D 




































0 


8 














































































P 




1 


1 


7 




1 


1 


8 


0 


A 


R 


E 


A 


C 




































0 


9 














































































P 




1 


1 


<^ 




1 


2 


2 


0 


P 


H 


0 


M 


E 




































1 


0 


















































































1 


2 


3 




X 


2 


3 




C 


U 


S 


T 


P 




































1 


1 














































































P 




1 


2 


^ 




I 


2 


7 


0 


L 


I 


M 


I 


T 




































1 


2 














































































P 




1 


2 


8 




1 


3 




0 


S 


L 


S 


N 


0 




































1 


3 














































































9 




1 


3 


1 




1 


3 


5 


2 


A 


M 


D 


U 


E 




































1 


4 














































































P 




1 


3 


6 




1 


3 




0 


P 




T 


P 


M 




































1 


5 
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Creating or Updating Source and Procedure Members 

You can use enter/update to create a new source or procedure 
nriember, add statements to an existing member, or change statements 
in an existing member. When you sign on to SEU and identify a 
member, SEU automatically selects enter/update for you, so the first 
display you see will include the enter/update prompt at the bottom of 
the display: 



0015.00 



FCUSTHSTRU 
CUSTMSTR 



S 
256 



1 

5 I 



01 



096 SEULIB 
Z DISK 



AR230R 





1 


1 ARCOD 




35 


59 CUSAl 




60 


84 CUSA2 




85 


109 CUSA3 




110 


111 STATE 


p 


112 


1160ZIPC0 


p 


117 


1180AREAC 


p 


119 


1220PH0NE 




123 


123 CUSTP 


p 


124 


1270LIMIT 


p 


128 


1300SLSN0 . 


p 


131 


1352AMDUE 


p. 


136 


1390DLTPM 



Wl 



■■i 



When you are working with a member during a job and you want the 
enter/update prompt again, press the Enter/Update command key 
(Cmd 5). 

Chapter 1 also explained that what you see on the display when you 
sign on to SEU depends on whether the member exists or not. If you 
identified a new member, a blank Z-display is shown. 

If the member already exists, the first 16 lines of data are displayed (as 
shown in the previous example). You can use the roll keys to roll 
through the statements and review the data. 
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Adding Statements 



To add a statement, type a new statement number in response to the 
enter/update prompt and press the Enter key. For example, if you 
want to add a statement between statements 3 and 4, enter any 
number between 3 and 4, such as 3.1, in response to the enter/update 
prompt. 

Changing Statements 

To update an existing statement, enter an existing statement number 
in response to the prompt. For example, if you want to change 
statement 5, enter a 5 in response to the enter/update prompt. If you 
specified member type A, F, W, or R, SEU displays that statement 
using the correct display so you can change the data. If you specified 
member type S or if you want a different display, press the Select 
Display command key (Cmd 3) and choose the necessary display. 
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Removing Statements 



Use delete to remove statements from a source or procedure member. 
You can remove one statement at a time or several consecutive 
statements at a time. Select delete by pressing the Delete command 
key (Cmd 4); the following delete prompts are displayed: 




16 

0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008.00 
0QQ9.00 
.0010.^0 
0611.00 
0012.00 
0013.00 
0014.00 
0015.00 





1 1 ARCOD 

60 84 CUSA2 
85 109 CUSA3 
m,ni STATE 
'{1602 rPCD 
"nSOAREAC 
119 1220PH0NE 

123 123 CUSTP 

124 1270LIMIT 
128 1300SLSN0 
131 1352AMDUE 
136 1390DLTPM 





• Delete, starting from statement number: Enter the 
statement number of the single statement you want to remove, or 
enter the statement number of the first statement in the series you 
want to remove. 

• Ending with statement number: Enter the statement number 
of the last statement in the series you want to delete. You can 
leave this blank if you are removing only one statement. 

If you enter the same statement number for the first prompt as for 
the second prompt, SEU will respond with the message: 

Delete starting/ending stmt equal-one stmt assumed 

After you type in the statement numbers you want to remove, press 
the Enter key to enter the responses. SEU displays the first and last 
statements to be removed so you can make sure the responses are 
correct before the statements are actually removed. 

Press the Enter key again to remove the statements. If you do not 
press the Enter key this second time, SEU ignores your responses and 
does not remove the statements. 

If you decide not to remove the statements, do not press the Enter key. 
Press the Delete command key (Cmd 4) again; you will return to the 
delete prompts, where you can change your responses. Or press 
another command key to select another use of SEU. 

Note: If you remove all statements from a member and take one of 
SEU end-of-]ob options 1 through 4, the member is removed from the 
library. The REMOVE procedure is faster than signing on to SEU to 
remove a member. REMOVE is described in the System Reference 
manual. 
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Copying or Moving Statements 



Use the Copy/Move command key (Cmd 10) to copy or move 
statements from one location in a member to another location in the 
same member. You can copy or move one statement at a time or 
several consecutive statements at once. 

The copy operation duplicates the statements you specify to a new 
location in the same member, but does not remove the original 
statements. The statements appear at both the original location and 
the new location. 

The move operation relocates statements from one location in a 
member to a new location in the same member. The statements are 
no longer at the original location. 

Note: It is best to use copy/move (rather than include) when 
changing or adding within a member because copy/move uses the 
data that you are currently updating. Include uses data that already 
exists in the library (permanent storage), and it will not reflect 
changes made to that data during the current job (work area). 

When you press the Copy/Move command key (Cmd 10), the 
following prompts are displayed: 



16 

jOOOI.OO 

0002. eo 

' 0003^.00 ' 
0004.00 
0005.00 
0006.00 
0007.00 

• '0008.1M, 

. OQ09.'60.' 

••OOlO'.^Jp' 

• m^^ 

■ OOlZ.obr 
0013.06 
0014.00 
0015.00 



CUSTMSTRU 
CUSTMSTR 



S 

256 



1 

5 I 



096 SEULIB 
2 DISK 



AR230R 



01 



1 1 ARCOO 
35 59 CUSAl 
60 64 CUSA2 
85 109 CUSA3 
110 111 STATE 
112 1160ZIPCD 
117 1180AREAC 
119 1220PH0NE 

123 123 CUSTP 

124 1270LIMIT 
128 1300SLSN0 
131 1352AMDUE 
136 1390DLTPM 



Wl 



11 



Chapter 3. Using SEU 3-5 



To copy or move a single statement, you do not have to enter an 
ending statement number. To copy or move a group of consecutive 
statements, respond to all the prompts. 

• Copy or move the statements: The default value for this 
prompt is COPY. If the response is not changed, the statements 
specified are copied. To move the statements specified to another 
location, change the response to MOVE or M. 

• To statement number: Enter the statement number that 
identifies the new location for the first statement (or the single 
statement) that you want to copy/move. The statement number 
you enter must not already exist in the member, and there must be 
enough room between the existing numbers for another number. 

• Starting from statement number: Enter the number of the 
first statement (or the single statement) you want to copy or 
move. 

• Ending with statement number: Enter the number of the last 
statement that you want to copy or move. You can leave this 
prompt blank if you are moving or copying a single state^ment. 

After you type in the responses, press the Enter key. SEU displays the 
first and last statements that are to be copied or moved so that you 
can make sure the responses are correct before the statements are 
actually copied or moved. 

Press the Enter key again to actually move or copy the statements. If 
you do not press the Enter key this second time, the statements will 
not be copied or moved. 

If you decide not to copy or move the statements, do not press the 
Enter key. Press the Copy/Move command key (Cmd 10) again to 
redisplay the copy/move prompts and change your responses. Or 
press another command key to select another use of SEU. 



How to Insert More than 99 Statements 



The following example shows you how to insert more than 99 
statements between two statements in a member. Assume the 
following statement numbers already exist: 

0003.00 
0004.00 
0005.00 
0006.00 

To insert more than 99 statements (by entering, moving, or including) 
between statements 3.00 and 4.00, press the Copy/ Move command 
key (Cmd 10) and respond to the prompts as follows: 

Copy or move the statements MOVE 

To statement number 3.01 

Starting from statement number 4.00 

Ending with statement number 

Press the Enter key and verify your responses. Press the Enter key 
again to move the statement. 

By moving the data in statement 4.00 into statement 3.01 , you make it 
possible to enter 198 statements numbered 3.02 through 4.99. 
Statement numbers now are: 

0003.00 
0003.01 
0005.00 
0006.00 
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Copying Statements from One Member to Another 



Note: This example assumes a second member (AR231 R) already 
exists in your library. If you do not have another member in the 
library, you will not be able to run the include example. 

Include is used to copy statements from one member to another. 
Statements copied by include are not removed from their original 
member. 

Include only duplicate data that already exists in a library, not data in 
the work area. In other words, you cannot use include to copy 
changes you just made during the current job. 

Example 6 

This example will copy statements 1 through 7 from member AR231 R 
into member AR230R. The statements will be placed between 
statements 8 and 9 of member AR230R. Both members are in the 
same library and both are SEU member type R. 

Assume that the following statements exist for member AR231 R: 




z 



096 



SEULIB 



AR23IR 
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0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008.00 
0009.00 
0010.00 



FCUSTAMT U 
ICUSTAMT 



01 



62 8 I 



6 DISK 
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P 
P 
P 
P 
P 
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14 
39 
43 
48 
53 
58 



52AH0UE 
13 CUSNO 
38 CUSNM 
420CRLIM 
472CHGTD 
5220VR30 
5720VR60 
6220VR90 



Enter or 



update statement number 
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To include statements from AR231 R, press the Include command key 
(Cmd 11 ). The include prompts are displayed: 
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0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008.00 
0009.00 
0010.00 

— _ 




0015.00 



CUSTMSTRU 
CUSTMSTR 



256 



1 

5 I 



096 SEULIB 
2 DISK 



AR230 




01 





1 


1 ARCOD 




35 


59 CUSAl 




60 


84 CUSA2 




85 


109 CUSA3 




110 


111 STATE 


p 


112 


1160ZIPCD 


p 


117 


1180AREAC 


p 


119 


1220PH0NE 




123 


123 CUSTP 


p 


124 


1270LIHIT 


p. 128 


1352AMDUE 


P 131' 


P 


136 


13900LTPM 



Type in the first three responses shown and press the Enter key: 
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00* 
lE.OO* 
0003.00* 
0004.00* 
OOOSiOO* 
0006.00* 
7.00* 

00* 

'OT69.00* 
0010.00* 



CUSTAMT U 
CUSTAMT 



1 096 SEULIB AR230R 
62 8 I 6 DISK 



01 



InClJMlci from library name . . 
Include from member name. . . . 
Including at statement number . 
Starting from statement number. 
Ending with statement number. . 



p 


1 


52AMDUE 




6 


13 CUSNO 




14 


38 CUSNM 


p 


39 


420CRLIM 


p 


43 


472CHGTD 


p 


48 


5220VR30 


p 


53 


5720VR60 


p 


58 


6220VR90 



Wl 
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Notice the AR231 R is shown at the top of the display so that you can 
view AR231 R and choose which statements to include and identify 
their statement numbers. Now type in the last two responses (1 and 
7) and press the Enter key. The following is displayed so that you can 
make sure your responses are correct: 




If the responses are correct, press the Enter key again to combine the 
data. If you do not press the Enter key again, the statements are not 
included. 

If you want to change the responses, do not press the Enter key. 
Press the Include command key (Cmd 11) again and type new 
responses,, or press another command key to select another use of 
SEU. 

Note: After you press the Enter key you can see how the data from 
the two members is combined by holding the Shift key ( {^) down 
and pressing the Roll Down key (Roll +). The following is displayed: 
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0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008.00 
0008.10 
M08.il 
).12 



FCUSTMSTRU 
ICUSTMSTR 01 
I 
I 
I 
I 

FeUSTAMt U 
ICUSIAMf V- 01 

I • 

■■■t ■•■■>. 
I 
I 
I 
I 

Include from library name 
Include from member name. 
Including at statement number '. 
Starting from statement number 
Ending with statement nunJier. 




0008.15 
0008.16 
0009.00 
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5 I 



096 SEULI8 
2 DISK 



AR230R 



Ul 



62 8 I 



P 

6 DISK 



1 1 ARCOO 
35 59 CUSAl 
60 84 CUSA2 
85 109 CUSA3 
110 111 STATE 

112 imiiPto 



P 1 52AHDUE 

fi 13 eUSNO 

.14 38 CUSNM 

P 39 420CRLIM 

P 43 472CHGT0 

P 117 1180AREAC 

, . . SEUL18 

. . . . AR231R 



'fs. 




Include Prompts 

To include a single statement, you do not need to enter an ending 
statement number. To include a series of consecutive statements, 
respond to all of the prompts. Responses are: 

• Include from library name: Enter the name of the library that 
contains the member from which you want to include statements. 
SEU will display the name of the library you are currently using. 

• Include from member name: Enter the name of the member 
from which you want to include statements. If neither P nor S is 
entered, the member type is assumed to be the same type as the 
member you are using. 

If the include member is a procedure member, type a comma and a 
P after the member name (name,P) to identify the member as a 
procedure member. Or you can also type an S after the member 
name to indicate a source member (name,S). 

• Including at statement number: Enter the statement number 
that identifies the place at which the included statements will be 
added to the member. 

Note: If you type in responses to the first three prompts and 
press the Enter key, SEU will display the member to be included 
from so that you can roll through that member to determine the 
correct numbers of the statements you are including. 

• Starting from statement number: Enter the number of the 
first statement (or the single statement) you want to include. 

• Ending with statement number: Enter the number of the last 
statement you want to include. You can leave this prompt blank if 
you are including a single statement. 

After you type in the responses, press the Enter key. SEU will display 
the first and last statements to be included, so that you can make sure 
the responses are correct. 
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Press the Enter key again to actually have the statements included. If 
you do not press the Enter key the second time, SEU ignores the 
include responses and the statements are not included. 

If you decide not to include the statements, do not press the Enter 
key. Press the Include command key (Cmd 1 1 ) again; you will return 
to the include prompts where you can change your responses. Or 
press another command key to select another use of SEU. 

Note: You can also use include to copy statements from one 
location in a member to another location in the same member, but the 
statements to be included must already exist in the library. In other 
words, you cannot use include to copy any statements you have just 
entered or changed during your current job. 



Locating and Replacing Characters in a Member 



You can do three things with scan/replace: 

• You can search through a member to locate (but not change) a 
particular sequence of characters. 

• If scan locates the characters, the statement containing the 
characters can be displayed using the Scan to Update command 
key (Cmd 14) so that you can manually make changes to the 

statement. 

• The scan and replace prompt on the scan display allows you to 
automatically substitute one set of characters for another set of 
characters within a single statement or throughout the member. 

How to Look through a Member Using Scan (without Making 
Changes) 

Example 7 

Note: Because you may not have had the second member available 
for the previous example, Example 7 will continue as if none of the 
data in Example 6 was included in member AR230R. 

You use scan when you want to locate a set of characters within a 
member. Scan will search the member and tell you if the characters 
are in the member. If scan does find the characters, it also shows you 
where the characters were first found. 

To search through a member and find a particular word or set of 
characters, press the Scan/Replace command key (Cmd 2). The 
following is displayed. In this example, to make SEU search for the 
word AM DUE, type in that word as shown: 
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0001.00 
0002.00 
0003.00 
0004.00 
0005.00 
0006.00 
0007.00 
0008.00 
0009.00 



mi'.W 

0013.00 
0014.00 
0015.00 



CUSTMSTRU 
CUSTMSTR 
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mm 
■HI 
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096 SEULIB 
2 DISK 



AR230R 



W2 



1 1 ARCOD 
35 59 CUSAl 
60 84 CUSA2 
85 109 CUSA3 
110 111 STATE 
112 1160ZIPCD 
117 1180AREAC 




P' 124-H 
P 128 
P 131 135ZAMDUE 
P 136 1390DLTPM 



Scan characters 

Starting at; pbS^tfon . -.SS^i^'. 

Number of scan Ctiarairters ...... .~^^^^P> 

Scan and replace? ; 
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If you leave the second response blank, each statement is scanned, 
starting with the first position. Leave the third response blank; it will 
be explained later. At this time we do not want to replace AMDUE 
with anything else, so leave an N as the last response. 

Now press the Enter key and the following is displayed: 




The scan always starts with the second displayed statement- in this 
case, statement 2, and continues on through the entire member, back 
to statement 1 . 

The statement number of the first occurrence of AMDUE is displayed 
on the last line of the display. 

Also the statement where AMDUE was first located is displayed at the 
top of the display. 

If SEU cannot find the scan characters you entered, it displays this 
message on the bottom line: > 

The scan characters were not found in the member 



Scan Prompts 

You must at least enter a response to Scan characters or Number of 
scan characters. The following explains the possible responses and 
restrictions for each prompt. 

Note: To scan for lowercase characters, you must first press the 
Select Display command key (Cmd 3) and select the Z- lower format. 
After that, if the Scan/Replace command key (Cmd 2) is pressed, the 
scan prompts will allow lowercase responses. Only the Z- lower 
display allows you to enter lowercase responses. 

• Scan characters: This is the consecutive group of as many as 
25 characters you want to find (sometimes called a character 
string). Blanks are valid in any position of the group. If blanks 
are included at the beginning or end of the group, remember to 
include them in your count and enter a value for Number of scan 
characters. 

If you do not enter a response to this prompt, you must enter a 
value for Number of scan characters. If you do not enter any scan 
characters, SEU assumes the scan characters are blanks and 
searches for a group of blanks with the length you specify for the 
Number of scan characters prompt. 

Note: SEU searches for the scan characters in any form. For 
example, when scanning for the word ADD, SEU will display 
ADDITION, ADDRESS, or similar occurrences of the letters ADD. 
You can isolate the word ADD by including the blank before or 
after the group of characters. See Scan and Rep/ace later in this 
chapter for similar considerations when performing a scan and 
replace function. 

• Starting at position: This is the starting position of the scan 
characters within the statements you are searching. It limits the 
scan to starting at a particular position within each statement. The 
scan skips over any data in the statement up to the starting 
position and scans only the number of characters specified. 

For example, assume you want to scan the C-specification result 
field (columns 43 through 48) of an RPG source program for a 
specific name. You specify column 43 as the starting position, if 
there are six scan characters in the string, SEU scans only 
positions 43 through 48. 

This prompt is optional and can remain blank. If you leave the 
prompt blank, SEU searches the entire statement for the specified 
scan characters. When the scan characters are found, the 
statement where the characters are first located is displayed on the 
first display line. The scan continues with the next statement when 
you press the Enter key again. 
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• Number of scan characters: This is the number of scan 
positions, including blanks. Any number from 1 through 25 may 
be entered. If the number you specify is less than the number of 
scan characters you entered, SEU shortens the right end of the 
scan character string to this length. If the number you specify is 
greater than the number of scan characters you entered, SEU 
assumes blanks on the right end of the scan character string. 

This prompt is optional only if you entered a value for Scan 
characters earlier. If you do not enter a value, SEU assumes that 
the scan characters contain no blanks at the end, counts only the 
number of scan characters, and enters the value ifor you. 

• Scan and replace?: If you enter a Y, you can replace one set of 
scan characters with a set of replacement characters you specify in 
the next series of prompts. 

Refer to Scan and Replace later in this chapter for examples of the 
replace prompts. 

Enter an N if you do not want to replace the scan characters. The 
scan then continues and you will not see any of the replace 
prompts. N Is the default value for this field. 

If the scan characters are not found, SEU displays the message at the 
bottom of the display: 

The scan characters were not found in the member 

Note: If the first statement located by the scan is not the statement 
you want, press the Enter key to continue the scan. 



Scan and Replace 



Example 8 

Many times you need to make several changes to data in your 
statements. If the same data appears several times within several 
statements, you want to make sure the change is made in each place, 
for example, changing CUSTMSTR to CUSTMAST. 

SEU can make several changes at once for you. 

To make sure the change is made every place the diata appears, and 
each change is correct, use scan/replace. 

Note: See When Scan and Replacement Characters Aren't Equal in 
Length later in this chapter for your considerations when the number 
of scan characters is different from the number of replacement 

characters. 



Replace is an option of scan, and you can use it by pressing the 
Scan/Replace command key (Cmd 2). Again, notice the last scan 
responses are displayed. Enter the new responses shown, but be sure 
to type a Y in response to the last scan prompt like this: 
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The following is displayed. Because you are replacing CUSTMSTR 
with CUSTMAST, enter CUSTMAST as the replacement characters: 




Although statement 14.0 is at the top of the display, SEU will start the 
replacement with the second displayed statement (statement 1 5.0) 
and continue back through statement 14.0. 



Press the Enter key; the next display is shown: 




The number of statements in which replacements were made is 
indicated on the bottom line. 

To see how the statements were changed, hold down the Shift 
key iCt) and press the Roll Down key (Roll + ): 
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Scan characters . . . 
Starting at position. 
Number of scan characters 
Scan and replace? 



CUSTMSTR 
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Replace Prompts 

You must enter either the replacement characters or the number of 
replacement characters. You may enter both, however. If you enter 
only the number of replacement characters, SEU assumes the 
replacement characters are blanks and substitutes blanks for the scan 
characters. 

You can remove the scanned -for characters by leaving the 
Replacement characters prompt blank and entering a 0 for Number of 
replacement characters. SEU removes the scan characters and moves 
the data to the left to close up the empty space. 

Replacennent characters: These are the characters SEU uses to 
replace the scan characters you specified. From 0 to 25 alphameric 
characters can be entered. 

This prompt is optional and can remain blank if you enter a value for 
Number of replacement characters. When you do not enter any 
replacement characters, SEU assumes the replacement characters are a 
string of blanks with the length you specify for Number of 
replacement characters. 

Note: The replacement characters will replace the scan characters 
wherever the scan characters are found. For example, assume you 
enter ADD for Scan characters and SUB for Replacement characters. 
ADDITION becomes SUBITION, ADDRESS becomes SUBRESS, and 
so on. You can isolate the scan characters by including, as 
scanned-for characters, any blanks that appear at the beginning 
and/or end of the scan characters. 

Number of replacement characters: This is the number of 
replacement characters SEU uses to replace the scan characters you 
specified. This prompt is optional and can be left blank if you entered 
replacement characters. When this prompt is left blank, SEU counts 
the number of replacement characters you entered (including blanks 
embedded within the group of characters) and displays that number. 
SEU does not count blanks at the end of the replacement characters. 
Some things to remember for this prompt iare: 

• The number of replacement characters can be any number 0 
through 25. 

• Enter 0 to remove the scan characters wherever they have been 

found and close up the space. 

• If blanks are to be included at the end of the replacement 
characters, be sure to include them in the number of replacement 
characters. 

If you enter a value that is less than the number of replacement 
characters entered, SEU shortens the right end of the string of 
replacement characters to this length. If you did not specify any 
replacement characters, SEU assumes a string of blanks the length of 
the value you entered. 

See When Scan and Replacement Characters Aren't Equal in Length 
later in this chapter for considerations when the number of scan 
characters is different from the number of replacement characters. 

Replace once per statement?: A response of Y to this* prompt 
limits the replacement to only the first time the scan characters are 
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found within a statement. A response of N means the scan characters 
are replaced everywhere they are found within the statement. 

If you leave this field blank, and did not enter a starting position on 
the previous scan display, the default is N. However, if you entered a 
starting position on the earlier display, the default is Y. 

End of replace area: This is the ending or right-margin position of 
the data that will be scanned and replaced within a statement. Data 
beyond this position in the statement will not be replaced. For 
example, in an 80-column statement, if the end of the replace area is 
60, columns 61 through 80 will not be scanned or shifted. 

When you do not enter a response for this prompt, SEU assumes that 
the end of replace area is the end of the statement. When you do 
enter a response for this prompt, SEU limits the scan and replacement 
to a specific portion of each statement. This will protect any data to 
the right of the changed area that should not be shifted out of its 
position. 

Ending with statement number: This is the number of the last 
statement that will be scanned and replaced within the member. If a 
last statement number is not entered, SEU continues to scan and 
replace throughout the entire member. To limit the number of 
statements that are scanned, enter a last statement number. 

Note: The scan and replace always begins with the second 
statement on the SEU display when the scan responses were entered. 
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When Scan and Replacement Characters Aren't Equal in Length 

When the number of scan characters is different from the number of 
replacement characters, one of the following will happen: 

• If there are more replacement characters than scan 
characters: 

This means you are trying to add more new characters than you 
took out of the statement. To allow for this, data is shifted to the 
right to make room for the replacement characters to be inserted. 
However, shifting will not occur beyond the position you specify 
for the End of replace area prompt. 

if you do not specify an End of replace area, all data in the 
statement to the right of the replacement characters is shifted by 
SEU to make room for the replacement characters-as long as 
there are blanks in the end positions of the statement. 

Note: This shifting of data will reposition some data and could 
cause syntax errors for RPG or WSU programs. 

For example, replacing CUSTMST with CUSTMAST requires a 
shift of data to the right as the following example shows: 



OOtSa'.OO // FILE NAME-CUSTMST,UNIT-F1 
0003.00 // FILE NAME-CUST0R0S,UNIT-F1 
0004.00 // RUN 



X 120 SEULIB 



OE400R 



Scan characters 

Starting at position 

Number of scan positions 

Scan and replace? Y,N 
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Enter the replacement characters: 



^16 1 120 SEULIB OE400R 

0002.00 // FILE NAME-CUSTMST,0NIT-F1 

0003.00 // FILE NAME-CUSTORDS, UNIT- Fl 

0004.00 // RUN 




''MipUcmeint characters 

Number* of replacement positions 
Replace once per statement? . . . 
End of replace area 
Ending with staten^ent, number.. 



. Y,N 



N 

120 
0002. 00 



When you press the Enter key, the scan prompts are redisplayed 
and the first statement changed is displayed on the second line of 
the display. The number of statements changed is noted at the 
bottom of the display. • 



1 120 SEULIB 



OE400R 



0003.00 // FILE NAME-CUSTOROS.UNIT-Fl 
0004.00 // RUN 




Scan characters 

Starting at position. . . 
Number of scan positions 
Scan and replace? . . . . 
SEU-0597 



. . CUSTMST 

'. 07 
Y,N Y 
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If data is to be shifted to the right to make room for the 
replacement characters, there must be enough blank space 
available at the end of the statement for the shift. 



If there is not enough blank space available, an error occurs. SEU 
redisplays the scan and replace prompt with the affected statement 
on the first line of the display. You cannot change the responses 
to the scan and replace prompt at this time. You should note the 
error and statement number for correction later and press the Enter 
key to continue. 

Note: If an error occurs and you do not continue the 
replacement, all replacements that have occurred up to the error 
will remain. 

If there are fewer replacement characters than scan 
characters: 

The data between the replacement characters and the end of 
replacement area is shifted to the left to close the gap created by 
the replacement. Blanks are inserted between this data and the 
end oif the replacement area. 

Note: Again, this could cause syntax errors for an RPG or WSU 
member. 



For example, replacing CUSTMAST with CUSTMST requires a 
shift of data to the left, as the following example shows. 

Enter the scan characters, blank out the number of scan 
characters, and make sure that a Y is in the last position: 



16 120 SEULIB OE400R 

0003.00 // FILE NAME-CUST0RDS,UNIT-F1 
0004.00 // RUN 



Scan characters 

Starting at position 

■gtf of scan positions 
and replace? Y,N 

>^:,^r'„§Stl-0597 



Enter the replacement characters: 



0002.00 // FILE NAME-CUSTMAST,UNIT-F1 
0003.00 //FILE NAME-CUSTORDS.UNIT-Fl 
0004.00 // RUN 



1 120 SEULIB 



\ 



Replacement characters 

Number of replacement positions 

Replace once per statement? Y,N 

End of replace area 120 

Ending with statement numtjter^ • ■ • 0002.00 



When you press the Enter key, the scan prompts are displayed 
again, and the number of statements changed is noted at the 
bottom of the screen: 



16 

0003. 00 

0004. 00 



// FILE NAME-CUSTORI 

// RUN 




1 120 SEULIB 



OE400R 



T-Fl 




Scan characters 

Starting at position. . . 
Number of scan positions 
Scan and replace? . . . . 
%ir-0597 



CUSTMAST 



. . 08 
Y,N Y 
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How to Make Changes to a Statement During a Scan 



Examples 

You may want to locate and change data within a member. For this 
example, search for LIMIT and change it to CR LI M. 

To scan for the data and be able to update it, press the Scan/Replace 
command key (Cmd 2). Notice the last scan responses are still 
displayed. 

Type in LIMIT as shown in the following display: 




FCUSTMASTU 
CUSTMAST 



-..0004.00 
' 0005.00 
0006.00 
0007.00 
0008.00 
0009.00 
0010.00 
0011.00 

■.DO 
,.00 

0015 !oO 



Scan characters. . 

Starting at position 

Number of scan characters 

Scan and replace? Y,N N 




1 

35 59 aiSAl 
60 M LUiA2 
£5 IC 
110 11 
P 112 ll^ZIPCD 
P 117 1180AREAC 
P 119 122OPH0NE 
123 123 CUSTP 
P 124 1270LIMIT 
P 128 I300SLSN0 
p-131 13S'2AMDUF 
P 136 1390DLTPM 



Then press the Scan to Update command key (Cmd 14), rather tfran 
the Enter key. 
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When the scanned-for characters are found, SEU displays the 
statements so that you can change them. 

Change LIMIT to CRLIM, as shown, and press the Enter key to enter 
the change: 




1 096 SEULIB AR230R 



123 



123 CUSTP 



W2 



1 2 3 4 5 6 7 

1234567890123456789,01234567890123456789(J1234S6mt»^3l5678901234567890l23456789 

I /^^l\/fjj:%''\ P124'1270' 

8 9 0 1 2 

01234567890123456789012345678901234$67890 



Enter or update statement nun*er . . . . . * . . . . . . . 

SEU-0569 ^.^ , 

053 Is the positfoft of the scan^^^^^f^. 

. . ■ . 



0012.00 



SEU then displays the next statement (in the example, statement 15) 
in enter/update even though it may not contain the scan characters: 



I 096 SEULIB AR230R 
P 124 1270CRLIM 



16 120 Z 
I 



Update 



W2 




901234567890123456789 



P 128 1300SLSN0 



01 2345678901 2345678901 2345678901234567890 




To continue the scan to update, press the Scan to Update command 
key (Cmd 14) again. 
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Print Option for Replace 



When the print option is on, SEU prints the "before" and "after" 
version of each statement in which a replacement was made. The 
before-replacement version of the statement is identified with three 
hyphens (---). The after- replacement version of the statement is 
printed as it now exists. 
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Scan and Rep/ace Using Ideographic Characters 



You may scan for ideographic characters if your system has the 
Ideographic Character Generator feature. This section contains 
material unique to an ideographic system, and should be used in 
addition to other information in this manual. 

The string of ideographic characters must be preceded by a Shift Out 
(SO) character and followed by a Shift In (SI) character. The SO 
occupies one position, each ideographic character occupies two 
positions, and the SI character occupies one position. 

Considerations 

In ideographic mode, the entries for the Scan characters will 
automatically be bracketed with SO and SI characters. However, you 
may be scanning for a particular ideographic character in the middle of 
a character string. This character would be positioned away from both 
the SO and SI characters. 

To handle the above situation, a new line was added to the scan 
display. A Y (yes) response to First Character Is Omitted From Scan 
will remove the SO character from the scan. A N (no) response will 
leave the SO character as part of the scan characters. N is the default 
entry. 

To include or exclude the Si character, simply adjust the Number of 
scan positions entry. 
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Example 10 



You may want to search a message member to f ind and change an 
ideographic character. To find iy) in the character string 
( t'^nizyz^ F )' try the following example. 



First Character Is Omitted From Scan 



Y 



Scan characters , 

Starting at position 

Number of scan positions 
Scan and replace 



/ 0 — 1»0 \ 



2 



N 



The way the character ( 'jf ) is located in the character string 

( e"^D Z/5«^' f)» it does not have a SO to its immediate left. A Y is entered 

here to omit the automatically supplied SO from the scan. 

The character is entered, and automatically bracketed with a SO and a 
SI character. 

The Starting at position prompt is left blank, so you will find the 
character wherever it appears. 

A 2 is entered for the number of scan positions because each 
ideographic character is two positions long and you do not want the 
SI character bracketing the scan character to be included. 

N is the response to scan and replace. Properly bracketed ideographic 
character strings can be replaced automatically in the same way 
alphameric character strings can be replaced. However, unbracketed 
ideographic characters cannot be replaced automatically. 

SEU will find your character in the character string and display the 
statement so that you can change it in the normal fashion. 



Translating Messages 

Note: Before running this example, you may want to refer to the 
CREATE procedure in the System Reference manual to better 
understand how the source messages member Is created. 

The example will use a member named MESSAGES with statements 
80 characters long. MESSAGES looks like this: 

MEMBER MESSAGES LIBRARY 8EULIB SEU EOJ PRINTOUT DATE 12/17/82 TIME 08.45 

IBM SYSTEM/36 SOURCE ENTRY UTILITY 



MESSAGES »1 








0101 


THIS 


IS 


THE 


FIRST MESSAGE 


0102 


THIS 


IS 


THE 


SECOND MESSAGE 


0103 


THIS 


IS 


THE 


THIRD MESSAGE 


0104 


THIS 


IS 


THE 


FOURTH MESSAGE 


0105 


THIS 


IS 


THE 


FIFTH MESSAGE 



»»»» END OF SEU PRINTOUT 



You can translate your message into other national languages by using 
SEU message translation. Message translation is available for existing 
message source members by specifying member type T at SEU 
sign -on: 

^ , . \ 

J SEU PROtEOURE Optional-* ; 

ii Source entry uttlity (SEU) is a program thx allows you to create, 

change, remove, and locate statements in source and procedtire meofeers 




Note: If you do not specify a statement length of 80, SEU may issue 
a warning message that data will be lost. Source type members can 
have statements 96 characters long, but message translate only allows 
80 characters. Make sure your messages are not longer than 80 
characters. 
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You are prompted to enter a translation for the first message (0101): 




Enter the message number 




Enter the translated version of the message and press the Enter key: 




V J 



You can continue to enter translations. When you reach the last 
statement in the source member (by entering translations or pressing 
the Enter key), SEU displays the message statements and the 
translations. 



Each translated statement is assigned the same four-digit message 
identification code (IVIIC) number as the untranslated message. As a 
result, the source member contains both the untranslated message and 
the translated message for each message (or MIC): 



Message Control 
Statement 
Untranslated 
Messages 
Delimiter 
Statement 

Translated 
Message 

End of Member 
Message 




^ Enter the laessagr i 



* • • * • • " 



MESSAGES 



Notice that AOOO is stored after the last untranslated message. This is 
called a delimiter statement and is a temporary record added at the 
end of the member by SEU at sign-on. The delimiter tells SEU where 
the original message statements end and the translated messages 
begin. 

After a translation has been entered, as many as four untranslated 
statements of the next message set can be displayed. A message set 
consists of consecutive statements that contain an asterisk (*) in 
column 1 or consecutive statements that contain the same MIC 
number in columns 1 through 4. Comment statements (identified by 
an asterisk in column 1) are displayed for possible translation. 

You can enter more lines for a translated message than were used to 
enter the untranslated message. 

Once you have added the translated statements to the message source 
statements using message translation, use the CREATE procedure to 
get a message load member. When you run the CREATE procedure, 
the source member must contain only the message control statement 
and the translated messages. 

Either create a new source member and, using include, copy only the 
message control statement and the translated version of the messages 
to the member. Or, delete the original messages and the AOOO 
delimiter statement from the member. More information on how to 
use the CREATE procedure is in the System Reference manual. 
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Inserting Translations 



If you have already added an untranslated message statement into the 
message member, you can also add a translation for the message. 
However, when you insert a sequence of translations, you should 
insert them in ascending message number order so that a statement 
number will be available at the logical position required: 

SEU inserts the translations in numerical order according to the 
message number. For example, SEU inserts the translation message 
01 07 after the translation for message 0105. SEU determines where 
to place the translation by adding 0.01 to the SEU statement number 
of the previous statement. 

For example, assume you have the following messages and 

translations: 

(00009.00) 0107 This is the eighth message 
(00010.00) 0108 This is the ninth message 
(00011.00) 0109 This is the tenth message 

(00012.00) AOOO 

(00013.00) 0104 This is the fifth translated message 
(00014.00) 0105 This is the sixth translated message 
(00015.00) 0108 This is the ninth translated message 
(00016.00) 0109 This is the tenth translated message 



To insert translations for messages 0106 and 0107, enter 0106 first. 
SEU determines that the translation for 0106 must be inserted before 
the translation for 0108 and following 0105. So, SEU adds .01 to 
message 0105's statement number (00014.00) and inserts the 
translation for message 0106 at statement number 00014.01. 

If you had inserted message 0107 first SEU would have determined 
that 0107 should be inserted between 0105 and 0108 and placed the 
translation for 01 07 at statement 0001 4.01 . There would then be no 
room between statements 00014.00 and 00014.01 for message 0106's 
translation. An error message would be displayed. 



You would have to use move/copy to move the translation for 
message 0107 (statement number 00014.01) to another location to 
make room. 

Summarizing Message Translation 

When you sign on to SEU and specify an SEU member type of T, SEU 
determines whether the message member exists and if the member 
contains the delimiter statement with AOOO in positions 1 through 4. 

The determination results in one of the following displays: 

• If the member specified at SEU sign^on does not exist in the 
specified library, a blank Z-display is shown so that you can begin 

entering message statements. 

• If the member exists, the first eight statements following the 
message member control statement are displayed on the screen in 
the prompting mode of the message translate function. 
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Notes: 

1 . The first time you try to enter translations for an existing 
member, SEU inserts the delimiter statement in the member. 

2. All the uses of SEU (enter/update, move/copy, delete, and 
include) are available to help you make any necessary changes 
to the message source member. 
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Chapter 4. Displays To Guide You 



As you saw in Chapter 1, SEU offers displays (sometimes called 
specification displays or display formats) to guide you when entering 
or changing statements. 

All of the displays are stored together in two load members, 
#SE@FORM and #SE@XTRA, Refer to Storing New or Chariged 
Displays in Chapter 5 for more details. 
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SEU-Supplied Displays 

SEU-suppiied displays available to guide you include: 

• Free-form, for entering and changing statements for which special 
displays do not exist, like OCL 

• RPG II and auto report, for entering and changing RPG II and 
auto report specifications 

• Work station utility (WSU), for entering and changing WSU 
specifications 

• SFGR, for entering and changing display formats used by the 
display format generator utility program ($SFGR) 

• Command, to enter and change IGC character entries 

• Assembler, for entering and changing assembler and macro 
processor instruction statements 

• FORTRAN IV, for entering and changing FORTRAN IV statements 

• COBOL, for entering and changing COBOL statements 

• AUTOR, for entering source statements for automatic response to 
messages 

• Message, for entering source statements for messages 

• Sort, for entering and changing sort sequence specifications 

• Magnetic character reader, for entering and changing 
specifications for the IBM 1255 Magnetic Character Reader 

m BGU, for entering data for the Business Graphics Utility. 

More detail on each display is found later in this chapter. 
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What the Displays Do for You 



Chapter 1 explained that you can get a list (menu) of the SEU 
displays by pressing the Select Display command key (Cmd 3): 



1 z 


17 


WSU-J 


2 Z-LOWER 


IS 


WSU-E 


3 H 


19 


WSU-T 


4 U 


20 


WSU-M 


5.F 




WSU-S 


6 G 


22 


WSU-D 


7 E 


23 


WSU-C 


8 L 


24 


SFGR-S 


9 T 


25 


SFGR-H 


10 I 


26 


SFGR-D 


11 J 


27 


D-CONT 


1,2 -X 


28 


SORTH 


15 0 


29 


SORTRF 


14 P 


30 


SORTRC 


15 K 


51 


SORTF 


16 A 


32 


ASSEM 


Enter the 


number 


of the 



Select display ^ . , 

||»^^^^ ' ' 1 ^ 

36 SDA»< 52 

37 SDADl 53 

58 SDAD2 ■:-^':-^-5A:' 

59 DOC-H 55 

40 AUTOR 56 

41 MESSAGE $7 

42 SRT-HEA0 58 

43 SRT-RECD 59 

44 SRT-CNST 60 

45 SRT-FLD 61 

46 MICRSYS 62 

47 MICRSTCK 65 

48 64 




When you select a display, that display guides you when you are 
entering or updating statements. Column positions are marked on the 
display, and fields are separated by blank spaces, or text is given that 
describes each field. 
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For example, some of the displays relate to the specification sheet 
used to write (or code) in a programming language. The following 
example illustrates the relationship between the l-display and the 
I -specification sheet: 



IBM 



Internaiional Businets Machines Corporaiic 



RPG INPUT SPECIFICATIONS 



Program 


Keying 
Instruction 


Graphic 
















Card Electro Number 


Prosrammer | Date 


Key 























GX21-9094. UM/050* 
Printed in U.S.A. 
75 76 77 78 79 80 

Identification I I I I I I J 




After you select a display, the length of the display is shown in 
positions 7 through 9 of the status line, and the name of the display is 
shown in positions 13 through 20. In the previous example, the 
length is 96 and the name of the display is I. (See Line 1 is the Status 
Line in Chapter 2 for more details on the status line.) 
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The Order of the Displays When Entering a Member 



When you sign on to SEU and identify a member, the Z-display is 
automatically selected by SEU, This display will continue to be used 
for each statement you enter or change unless you select a different 
display using the Select Display command key (Cmd 3). 

When you are entering SEU member types W or F, and you have 
selected your first display, SEU knows that the displays for those 
member types are used in a particular order. Based on the previous 
statement, SEU aids you in the selection of the appropriate display. 

For more information, see WSU or SFGR later in this chapter. 
The Order of the Displays When l\/laldng Changes 

If you are adding or updating statements, SEU determines the display 
type of the statement that precedes the statement being entered, then 
selects the same display. SEU determines the type of display by the 
character in column 6 of the previous display. 

If the statement to be updated is in an SEU member type of W or F, 
SEU will begin selecting the displays in sequence once you choose 
the first display. 
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What Type of Field Is It? 



Each SEU-supplied display (except the free-form) has some 
predefined fields. That is, there are fields that will accept only certain 
types of data. There are fields that affect the way you move the cursor 
from field to field. There are fields that are protected. And there are 
fields that are set up to always contain the same data. 

Note: On the SEU displays, certain types of fields are shown in 
different ways. Numeric and alphameric right-adjust fields are 
displayed in reverse image. Headings for protected fields are 
underlined. Headings for autoskip fields are also underlined if 
autoskip is on. For example: 



Protect Field Right-Adjust Field 





Enter 



16 096 I 
I 

1234S 6 78901234/5678 90 



09fi SEULXIB \ \IR230R 
170 111 ST WE 



Wl 



12 2 



2 2/3 3 3/ 
567 234 



34 4 4 4\ 4\5 \^ 5 56 
901 2 3 345678 90 

P 112 116 0 ZIPCD 



6666 67 7{ 7 88 9 

12 34 56 78 90 1234 567890 1234S678^1Z34S6 



Enter or update statement nuriber 



0008.00 



If the autoskip is turned off, the underline is removed from the 
autoskip fields. 
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Alphameric Fields 



Any letter, number, or special character on the keyboard is a valid 
entry for an alphameric field. 

Numeric Fields 

Valid entries for a numeric field are the numbers 0 through 9 as well 
as the + (plus sign), - (minus sign), . (decimal point), blank, and , 
(comma). 

Protected Fields 

Protected fields are fields that are skipped. You cannot enter data into 
a protected field. Protected fields also save you time, since you do 
not have to manually move the cursor past a field that is protected. 

Autoskip Fields 

Autoskip fields (a special type of protected field) are fields that the 
cursor skips over whenever the SEU autoskip option is on. 

Position 39 of the status line reflects the status of the autoskip option: 
A if it is on, blank if it is off. The Autoskip command key (Cmd 1 ) 
reverses the status of the autoskip option. 

Constant Fields 

Constant fields contain predefined constants (data that is always in a 
certain field). For example, position 6 in RPG II specifications is a 
constant because it always contains a letter that identifies which 
specification you are using; F for file description specifications, I for 
input specifications, and so on. 

You can change the contents of a constant field if it is not specified as 
a protected field, which must be skipped. 

The constant field already has the constant entered when a new 
statement is being entered. 

Controlled Field Exit (Auto-Exit Field) 

When you enter enough data to fill every position of an auto-exit field, 
the cursor automatically moves to the next field in the statement. 

Note: The cursor automatically moves to the next field when an 
entry is made in a field that is only 1 character long. 
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AdjustlFill (Right-Adjust Field) 



If a field is specified as adjust/fill (right-adjust), the contents of the 
field are moved to the rightmost position of the field when you press 
the Field Exit or Field -t- key. 

If the field is defined as zero fill, the remaining positions to the left of 
the data are filled with zeros. If the field is defined as blank fill, the 
remaining positions are filled with blanks. 

The contents of the field are not right- adjusted if you press the Field 
Advance key. 

In the following example, assume you have a four- position, 
right-adjust, blank fill field and you type in three characters: 



16 096 F Update 1 096 SEULIB AR230R Wl 



1 111112 2 2 23 3 3 3 3 3 4 +555 
12345 6 78901234 5 6 7 8 9 0123 4567 8 90 1 2 34 5678 9 0123456 789012 3 456789 
F CUSTMAST U 

6 6667777 88 9 
012345 6 7 89 0 12 34 567890 1234567890123456 



Enter or update statement number 0001.00 
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When you press the Field Exit or Field+ key, position 1 in the field is 
left blank and the three characters you entered are moved to positions 
2, 3, and 4 and remaining positions are filled with blanks: 




1 111112' 2 2 23 3333 34 4 5 55 

12345 6 78901234 5 6 7 8 9 0123 4567 8 90 1 2 34 5678 9 0123456 789012 3 456789 
F CUSTMAST U ^ 



6 6667777 88 9 
012345 6 7 89 0 12 34 567890 1234567890123456 




Ideographic Fields 

Any specification listed on the Select display will accept ideographic 
characters (IGC) in alphameric fields. You may enter ideographic 
characters if you are in ideographic mode. IGC mode requires: that 
you have the IGC SSP on your system; that you are signed-on at an 
ideographic-capable display; and that you respond with a Y to the 
IGC prompt at sign-on. 

Each group of ideographic characters on each line must start with a 
shift out (SO) character and end with a shift in (SI) character. If an 
ideographic constant is continued on the next specification line (as a 
continuation of the constant) a SI character must end the first line and 
a SO character must start the next line. SEU will remove the SI, the 
SO, any blanks in between them, and put the constant together in one 
unbroken character string. Putting the character string together like 
this is called concatenation. 
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More Details About the SEU Displays 



Earlier in this chapter you saw a brief description of each type of 
display that SEU provides to guide you when entering statements. 
The following sections give a more detailed explanation of each 
display: 



1 

2 
5 

Ci 

5 

6 

7 

8 

9 
10 
11 

14 Pi 

15 K 

16 A 



Z 

Z-LOWER 
H 
U 
F 
G 
E 
L 
T 
I 
J 



Select display 



I^Hp 

17 WSU-J 

18 WSU-E 

19 WSU-T 

20 WSU-M 

21 WSU-S 

22 WSU-D 

23 WSU-C 

24 SFGR-S 

25 SFGR-H 

26 SFGR-D 

27 D-CONT 

28 SORTH 

29 SOIiTRF 

30 SORTRC 

31 SORTF 

32 ASSEM 




Enter the number of the specif. 



display you want. 




Free-Form 

SEU selects a free-form (Z-display) for the first display shown after 
sign -on. Free-form displays allow you to enter alphameric data into 
any character position on the display. There are two Z-displays: Z 
and Z-LOWER. 

The Z-display permits entry of only uppercase characters; Z-LOWER 
permits entry of lowercase and uppercase characters. You must use 
the Shift key ( ) to enter uppercase characters on the Z-LOWER 

display. 

Statements entered and updated using the free-form display can be as 
many as 120 characters long. In order to display all 120 character 

positions, free-form displays separate each statement into two fields: 
The first field is 79 positions long; the second is 41 positions long. 
The displays can be used to enter and change statements for which 
unique specification displays do not exist, such as OCL statements or 
BASIC statements. 
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RPG II and Auto Report 

The following RPG II and auto report (K and U) displays are provided 
for entering and updating RPG II and auto report specifications. Each 
RPG II and auto report display is 96 positions long. 

Specification Displays 



H Control specification 

U Option format used by RPG II auto report 

F File description specification 

G (F-Cont) File description continuation 

E Extension specification 

L Line counter specification 

T Telecommunications specification 

I Input specification (record identification) 

J (l-Cont) Input specification for columns 44 through 96 
(field description) 

C Calculation specification 

O Output specification (file identification and control) 

P (0-Cont) Output specifications for columns 32 through 96 
(field description) 

K Copy specification used by RPG II auto report 
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Checking Syntax of RPG II and Auto Report Statements 

SEU can check the syntax of RPG 11 and auto report statements that 
are specified at sign-on as SEU member type R or A. 

Limited syntax checking is offered as an option to help eliminate 
compile-time errors. SEU can diagnose many coding or typing errors 
that would result in an error, but SEU cannot diagnose all terminal 
compilation errors detected by the RPG II compiler. 

Fpr example, SEU does not detect errors that result from a conflict 
between entries in two or more statements. The syntax checking that 
is done is based on the display type used to enter or update the 
statement. When the F-format is used, for example, file description 
syntax checking is done. 

SEU does allow auto report entries on all RPG F-, I-, J-, 0-, and 
P-displays. For more information, see the manual Programming with 
RPG II. 

Error Detection 

If you specify SEU member type R or A for an RPG II or auto report 
member, SEU checks the syntax of each statement as it is entered. 
SEU can diagnose only one error each time it checks the syntax of a 
statement, even though a statement may contain several errors. 

If SEU finds a syntax error in a statement, it displays a diagnostic 
message. So that you can correct the error, SEU displays the 
statement again. When you press the Enter key after correcting the 
error, SEU again checks the syntax of the statement. 

If you press the Accept with Error command key (Cmd 12) after a 
syntax error is found, SEU accepts the statement whether or not an 
error still exists in it. If the print option is on and a syntax error is 
present, SEU prints the statement, followed by ***. SEU also prints an 
asterisk beneath the field that is related to the error and the message 
identification code (MIC) of the appropriate SEU diagnostic message 
after the asterisk. 

if the print option is on and you corrected all syntax errors in a 
statement, SEU prints only the corrected statement. 

A blank entry in a statement in an auto report member is not 
necessarily a blank entry after RPG II compilation, it may be modified 
by a statement being copied. Therefore, the level of syntax checking 
performed on auto report specifications is limited to the level of syntax 
checking performed on RPG II specifications. 

Note: The /COPY statement of auto report restricts copying to a 
maximum statement length of 96 bytes. 

Comments 

Comments are source language statements that have no effect on the 
source, but are printed as part of an output printout. SEU provides the 
A-display, with an asterisk (*) in position 7, that can be used by all 
programming languages except BASIC for comments. 



\Nork Station Utility (WSU) 



SEU provides displays for entering and changing WSU J-, E-, T-, M-, 
S-, D-, and C-specifications. Comments for WSU can also be entered 
or changed using the comment display, A. 

Each WSU display is 96 positions long. 

For a member type of W (WSU), the correct order for the displays is J, 
E, T, M, S, D, and C. Once you select the J -display, enter a 
statement, and then press the Enter key, SEU selects the E-display. 
SEU will continue to select the E-display until you select a different 
display (in this case, the T-specification). 

Once you enter a T-specification, SEU selects an M -display for you 
and will continue to select M-displays for you until you select another 
display (in this case, the S-specification). When you enter an 
S-specification, SEU selects the D-display and continues to select 
D -displays for you until you select a different display (in this case, C). 

When you are updating a member, SEU selects the appropriate display 
determined by the entry in column 6 of that statement. 

A WSU user can also use the SDA displays (SDAS, SDAD1, and 
SDAD2) for S- and D -specifications. These are descriptive prompting 
displays. A descriptive display means you are prompted for 
information and therefore do not need a specification (or coding) 
sheet to identify each column. 

A WSU user can also use the D-Cont display to continue the constant 
field from the D -specification. 
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This is the WSU-D display: 




16 080 SDAOl 



Update 



Seq No 
Line N 
Hand ent 

Pos cursor 
Protect fid 
High Inten 
Const type 



Form type 
Position ' 
Vkni fill 
Adjust/fin 
Blink fid 

Constant 




(hifpjut data 

''Self ^ft^; ' 

Ctl fid exit 

Underline 

Lowercase 



ARIOOU 



Fid len 
Allow input Data type 



Enable dup 
A«to rec adv 
Non-display 



Wl 




WSU edit 
Col sep 
Reverse image 

Continuation 



Enter or update statement number 



0004.00 



For more information on the WSU specifications, see the WSU Guide. 



SFGR 



SEU provides four displays for entering and changing display format 
specifications: SFGR-S, SFGR-H, SFGR-D, and D-Cont. These 
describe the display control (S) specifications, the application help 
(H) specifications, and field definition (D) specifications for the 
$SFGR utility program. 

If you specify member type F, once you select the SFGR-S display 
and enter an S-specification, SEU will select the SFGR-D display for 
you. When you are updating a member, SEU selects whichever 
display is appropriate depending on the entry in column 6 of that 
statement. 

Each SFGR display is 96 positions long. 

For more information about entries on the SFGR displays, see Entries 
on the Display Format Specifications in the manual Creating Displays. 

SFGR-S 

SFGR-S (also known as the S-specification) is used to enter the 
display control specification. At least one S-specification is required 
for each display format generated by $SFGR and must be the first 
statement in the member for each display format. SFGR-S provides 
general information about the entire display format such as: the name 
of the display format; whether lowercase letters can be entered by the 
operator; or how entered data will be sent to the user program. 

SFGR-H 

SFGR-H (also known as the application help specification) is used to 
specify an area on the format for which the programmer has defined 
help text. Application help specifications are optional. If they are 
coded, any H -specifications must immediately follow the 
S-specification and precede all D -specifications. 

SFGR-D 

SFGR-D (also known as the D-specification) follows the 
S-specification and the H -specifications. Each statement completely 
describes a field on the display format. There must be a statement for 
each field in the display format. 

D-Cont 

D-Cont (also known as the continuation specification for the 
D-specification) allows you to continue the constant data field from 
the D-specification if the constant wogid not all fit on the 
D-specification. 

DOC-H 

DOC-H (also known as the document help specification) is used to 
enter help information for document text. Unlike SFGR-H, 
documentation help is not sensitive to an area of the display. 
Documentation help text applies to the document displayed, not to the 
cursor location on the screen. 
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SFGR and WSU Format Prompting 



SEU provides prompting specification displays for entering or updating 
SFGR or WSU-S specifications, D-specifications and D-continuation 
specifications. The following specification displays have descriptive 
prompting rather than column definitions; that is, the name of each 
ifield is displayed to prompt you for a response: 

SDAS: Used for SFGR-S or WSU-S specifications 

SDAH: Used for SFGR- H specifications 

SDAD1 : Used for SFGR-D or WSU-D specifications 

SDAD2: Used for continuation of SFGR-D or WSU-D 



specifications 



This is a column -defihing display: 



16 096 SFGR-S 



Update 



1 096 USULIB ARIOOM 




0002 TACTRCV WSULIB FILEDEF 




1 1 1 12 2 2 41 

12345 6 78901234 56 78 90 1 2 34 



4 5 6 6 7 8 8 .v' .'rS^ • 

: 9012345678901234567890123 4567890123456789 0 1234567890123456 




Enter or update statement nui 




0003.00 




This is a descriptive display: 



16 080 SDAS Update 
0002 TACTRCV WSULIB FILEDEF 



1 096 . WSULIB 



Seq No. 
Start line 
Reset keybd 
Override 
Required 

Review record IDs 
Function keys 



Form type Format .name 

Lines to clear Lowercase -r 

Sound alarm Blink cursor 

Suppress input BSU start . 

Repeat ' Priority - 

insert record IDs ' 

Coamand keys "Key mask- -■ 



Enter or update statement number 



ARIOGU 



WSU format ID 
Return Input 
Erase Input 
WSU end 
Preprocess 
Null fin 



Wl 



0003.00 
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Command 



SEU provides a display for entering and changing ideographic 
characters. You may select the Command display only if your system 
has the ideographic support feature installed and you are signed on to 
an ideographic-capable display station. 

The display consists of two input lines of 60 bytes each. SEU will 
automatically insert the SO and SI characters as they are required. If 
the first input line does not have enough room for the input data, you 
I can overflow to the second input line (continuation). 

SEU will correctly handle the SI and SO characters and will unite the 
two input lines when the Enter key is pressed. 

Assembler 

SEU provides a display for entering and changing assembler language 
statements. Comments for assembler programs can be entered and 
changed using the assembler display if the autoskip option is off. 

The assembler display is 96 positions long. For more information on 
using the assembler specificatons, see the manual Programming with 
Assembler. 

FORTRAN IV 

SEU provides a display for entering and changing FORTRAN IV 
statements and comment statements. 

The FORTRAN IV display is 96 positions long. For more information 
on the FORTRAN specifications, see the manual Programming with 
FORTRAN IV. 

COBOL 

SEU provides a display for entering and changing COBOL statements. 

Continuation statements and comment statements for COBOL 
programs can be entered and changed using the COBOL display if the 
autoskip option is off. 

The COBOL display is 96 positions long. For more information on 
using the COBOL specifications, see the manual Programming with 
COBOL. 

AUTOR 

SEU provides a display for entering automatic response messages. 
You are prompted to identify the messages to which you want the 
system to automatically respond when a particular situation or error 
occurs. 
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Message 



This is a descriptive prompt for entering message member source 
statements. 



The following sort specification displays are provided with SEU. They 
can be used to enter and update both ideographic and 
non- ideographic sort sequence specifications. 



SORTH describes the type of sort you want to run. SORTRC and 
SORTRF describe which input records you want to include or omit 
from the sort. SORTRC describes a record type constant and SORTRF 
describes control fields and data fields to the sort program and identify 
which data fields will be included in the output file. 

Comments for sort can be entered and changed using the comment 
display, A. 

Each sort display is 96 positions long. For more information on using 
the sort specifications, see the Sort Guide. 

The following sort specification displays are also supplied with SEU. 
They can be used to enter and update only non-ideographic sort 
sequence specifications. 

Display 

Name Specifications 

SRT-HEAD Header Specification 

SRT-RECD Record selection, field comparison 

SRT-CNST Record selection, constant or keyword comparison 

SRT-CNST Field specification 

These displays are prompt displays, not 96-position coding form 
displays. 



SEU provides the MICRSYS display and the MICRSTCK display to 
enter or change specifications for the IBM 1 255 Magnetic Character 
Reader. For more information on using these displays, see IBM 
System 1 36 Using and Programming tlie 1255 Magnetic Character 
Reader, SC09-1046. 



Sort 



Display 
Name 



Specifications 



SORTH 
SORTRC 
SORTRF 
SORTF 



Header specification 
Record type constant specification 
Record type field specification 
Field specification 



Magnetic Character Reader 
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Display Lengths Can Be Different from Statement 
Lengt/is 



The number of character positions available for a particular display 
(display length) may be different from the number of positions 
available for a member type (statement length). 

In other words, although a source member can have as many as 120 
character positions, a display you choose- for example, the I -display- 
might have only 96 positions available. 

When you are entering a new statement and the statement length is 
greater than the length of the selected display, SEU adds enough 
blanks to the statement to extend it to the specified statement length. 
In this example, if the source statement length is 120 and the l-display 
length is 96, SEU accepts 96 characters of data and adds 24 blanks: 



96 

H 

Display Length 



96 120 
_f. ^ 

Statement Length 24 blanks 

added by SEU 




When you are updating a statement, and the statement length is 
greater than the display length, you may lose data. If SEU discovers 
data in positions beyond the length of the display, SEU displays a 
warning message. You can then select a longer display to avoid 
losing data, or you can press the Enter key and blanks are entered over 
the data: 



1 96 
I 1 

Display Length 



96 120 



Statement Length If SEU finds nonblanks 

here, SEU Issues a 
warning message. 
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If the length of a statement being entered or updated is less than the 
length of the selected display, you can enter data only within the 
limits of the statement length. If you try to enter data beyond the 
specified statement lengths, SEU truncates the statement at the 
statement length, displays an error message, and displays the 
truncated statement. You can press the Enter key to enter the 
statement as it is displayed. 



1 96 



Display Length 



80 



96 




Statement Length 



Truncated 
by SEU 
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Chapter 



5. Attention Programmers 



This chapter is for the programmer or the experienced user of the IBM 
System/36 and SEU. It contains explanations of extra things you can 
make SEU do for you, ways to do more complex jobs, and things to 
consider as you try out new ideas with SEU. 



There is an easier way to call SEU rather than being prompted, once 
you feel more comfortable with the utility. If you do not enter a 
member type, SEU assumes it is a source member. If you do not enter 
a library name, SEU looks for the member in the library you are 
currently using. Therefore, if you are working with a source member 
(for example, AR230R) that is in the same library you have been 
using, call SEU by typing: 

SEU AR230R 

When you press the Enter key, SEU assumes the member type is S and 
the member is in the current library. 

The member you named is then displayed for you. 



There Is a 



Shortcut to Calling SEU 
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SEU Procedure Command 



You can also call SEU using the entire SEU procedure command. The 
format of the SEU procedure command is: 



SEU 



member name> 



(SOURCE) 
P 

(PROC) 

A 

F 

R 

T 

U 



seu format member 
#SEaXTRA 



statement len gth 



]■ 



library name 
current 1 i brarv 



diagnosed source f 



lie] 
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member name Specifies the source member or procedure that you 
want to create or change. A member name can be as 
many as eight characters long and must begin with an 
alphabetic character (A through Z, #, $, or @). The 
remaining characters can be any combination of 
characters (numeric, alphabetic, and special). You 
should avoid using the following characters because 
these have special meanings in procedures: commas 
(,), apostrophes ('), blanks, question marks (?), 
slashes (/), greater than signs (>) and equal signs 
(=). Do not use DIR, LIBRARY, or ALL as a member 
name. 

member type 

S (SOURCE) Specify a library source member. If no parameter is 
specified, S (SOURCE) is assumed. 



P (PROC) 



Specify a library procedure member. 



Specifies an RPG II program that contains auto report 
specifications. The syntax of the RPG II program is 
checked by SEU. SEU displays the RPG specification 
for each statement in the source member. 

Specifies a library source member that contains 
display format S- and D-specifications. SEU displays 
the format specification for each statement in the 
source member. 

Specifies a library source member that contains an 
RPG II program. The syntax of the RPG II program is 
checked by SEU. SEU displays the RPG specification 
for each statement in the source member. 



T 
W 



Specifies a message translation source member. 

Specifies a source member containing work station 
utility (WSU) statements. SEU displays the WSU 
specification for each statement in the source 
member. 



SEU format member Specifies the name of the SEU display format 
member to be used to edit source statements. If no 
format name is specified, #SE@XTRA is assumed. 
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statement length Specifies the length for each source or 

procedure statement. This can be any 
decimal number from 40 to 1 20. If the 
member exists, the statement length of the 
member is assumed. If the member is being 
created, the values you can specify and the 
values that are assumed by SEU if no 
statement length is specified are as follows: 



Member 
Type 


Allowed 

Statement 

Length 


Assumed 

Statement 

Length 


SOURCE, 
S 


40 to 120 


96 


PROC, P 


40 to 120 


120 


A 


80 to 96 


96 


F 


40 to 1 20 


96 


R 


40 to 120 


96 


T 


40 to 120 


80 


W 


40 to 1 20 


96 



library name Specifies the library that contains or will 

contain the library member being changed 
or created. If no library name is specified, 
the current library is assumed. 

diagnosed source file While you are compiling a source member, a 

diagnosed source file can be created that 
will contain the source statements along 
with diagnostic and informational messages. 
SEU uses that file as input and allows you 
to make changes. The data in this file is 
then stored in the library as a source 
member. 

This parameter is used by the RPGONL, 
COBOLONL, and FORTONL procedures to 
allow the diagnosed source members to be 
edited. You do not need to specify this 
parameter. 

See one of the manuals Programming with 
RPG II, Programming with FORTRAN IV, or 
Programming with COBOL for more 
information on diagnosed source members. 

Example 

This example shows how to start SEU to create or change a procedure 
named PAYROLL. The procedure is contained in the current library: 



SEU PAYROLL,? 



An SEU Run Sheet 

You may want to design an SEU run sheet to simplify SEU 
instructions for someone else to use. An example of such a sheet is 
shown below. The example contains entries you would supply for 
another person to enter: 



O 



O 



SEU Job Sheet 

Date Submitted . 

Programmer L.G. PKilipS 

Job Number- 

Enter: SEU 

Member Name ARZ30R ; Member Type ; Format Member Name 

Statement Length ; Library Name SEUIIB; 

Use Displays: 

SEU Features: BcilJt , AvlVqSWp , &\|<\\ax CV\tt cVC 

EOJ Option: 

Coding Sheets Attached? ^ep No 
Listing Attached? Yes 

o Comments: - Er\W F and X spccs as SV\aWT\ 

- Use "RPCbC" ^ocA.dvjjrQ. cot«\rc\av\<S ^ cotx\p\\e. 



A run sheet is a very basic list of step-by-step instructions you give to 
someone to run a job for you. The run sheet can be kept with the job 
so the instructions are handy for anyone who needs to run the job. 
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How SEU 



Uses Storage Space 



Each SEU job uses a work area tn main storage and a work file on 
disk. The work file on disk contains a copy of the member you are 
using or creating. As you use SEU, the statements to be changed are 
read from the work file into a buffer in main storage. The contents of 
that buffer are displayed as you do your work. As you make changes 
to the data, it is written to another buffer reserved by SEU for storing 
changed statements. When this second buffer is filled up, SEU writes 
the statements back to the work file on disk to make room for more 
statements in the buffer: 




Whether you are updating an existing member or creating a new 
member, SEU sets up a work file. If you are updating a member, SEU 
places a copy of the member in the work file: 



Main Storage Disk 
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At the end of the job, the member is placed back in the library you 
specify. 

If you created a new member, SEU places the new member in the 
library you specify: 

Main Storage Disk 




If the updated member increased in size, it is placed in a new location 
in the library and system pointers to the original member are removed. 
Anyone who now uses the member will use a copy of the updated 
version: 



Main Storage Member Stored ^''^ 
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What if There's not Enough Space? 



You may get a message that there is not enough disk space: 

• At SEU sign-on: An error message is displayed stating there is not 
enough space available for the SEU work file 

• At the end of the job: If there is not enough space available for 
the data in the work file, a message is displayed stating that there 
is ho room for the work file. 

You will need to delete unnecessary data on the disk or run the 
COMPRESS procedure to free up unused disk space. See the System 
Reference manual for more information on this procedure. 

You may get a message that there is not enough library space: 

• At the end of the job: If SEU cannot find enough library space to 
restore the member, a message is displayed stating that there is no 
room for the member in the library (you may have increased the 
size of the member by adding statements). 

You will have to delete unnecessary members stored in the library or 
run the CONDENSE procedure to free up library space. If there is still 
not enough room in the library, a larger library or a different library will 
have to be created. See System Reference manual for more 
information on the CONDENSE procedure. 

If you get a message that there !s not enough disk or library space, 
select option 2 and press the Enter key. Once you have created the 
necessary space, sign on to SEU again. SEU will help you recover the 
member through a series of recovery prompts. The following section 
explains the recovery process. 
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How to Recover from Interruptions: Planned or 
Unplanned 



Your work can be interrupted for many reasons. For example, jobs 
might accidentally be canceled at the system console, there could be a 
power failure, or you might interrupt a job because there was not 
enough disk or library space available. 

If such an error condition exists, you can later recover data from the 
SEU work file by: 

• Signing on at the display station you were using at the time the 
error or failure occurred, and 

• Signing on to SEU the same way you signed on for the original 
job 

After you sign on to SEU again, SEU determines whether or not the 
work file exists and displays the message; 

SEU-0545 Work file already exists — is this a recovery run?... 
Note: SEU cannot recover from permanent disk errors. 
There are three options you can choose at this time: 

• Option 0: You are still in SEU and can continue the job. The 
first thing to do is check to make sure all your data is saved-the 
last data you entered may have to be reentered. 

• Option 1: You are still in SEU but you want to start completely 
over. SEU will remove the existing work file and create a new 
empty work file so that you can start again. 

• Option 3: You want SEU to save the work file but you do not 
want to do anything with it at this time. Choose this option if you 
aren't sure what you want to do or don't have time to go through 
the recovery steps at this time. 

When you choose option 0 to continue, SEU checks the parameters 
you used to sign on. If they do not match the previous sign-on, SEU 
issues message SEU-0546. 

Either you used different parameters to sign on for recovery or 
someone else was using SEU at that display station when the error 
occurred. Choose option 3 so that you don't remove the work file. 
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SEU 



-Supplied Displays in a Format Member 



When you sign on to SEU, a prompt asks you for an SEU format 
member and supplies a default value of #SE@XTRA. The format 
members are where the SEU -supplied displays (such as the Z-dlsplay) 
are stored. The displays are stored in two load members: 
#SE@FORM and #SE@XTRA. #SE@FORM is stored in #SEULIB, 
and #SE@XTRA Is stored in #LIBRARY: 

#SE@FORM ^E@XTRA 
Z 





Se 


lect display / 








33 


FORTRAN 


49 








COBOL 


50 






35 


SDAS 


51 






36 


SDAH 


52 






37 


SDADl 


53 






38 


SDAD2 


54 






39 


DOC-H 


55 






^iO 


AUTOR 


56 






41 


MESSAGE 


57 






42 


SRT-HEAD 


58 






43 


3RT-RECD 


59 


28 


SORTH 


44 


SRT-CNST 


60 


29 


SDRTRF 


45 


SRT-FLD 


61 


30 


SORTRC 


46 


MICRSYS 


62 


31 


SORTF 


47 


MICRSTCK 


63 


3Z ASSEM 


48 




64 



Enter the number of the specification display you want. 



Source members for #SE@XTRA and #SE@FORM contain 
specifications that define each SEU-supplied display. The 
specifications that describe a particular display are called a display 
format. The load members contain the compiled display 
specifications. 



Note: Loading the source for the format members is optional when 
SEU is loaded onto the system, so they may not be on your system. 
The load members are required If you are using the SEU-suppiied 
displays. 

You can create your own displays to suit your needs, or you can 
change an SEU-supplied display or its name. (You cannot, however, 
change the name of the Z-dlsplay.) You can reduce the size of the 
format members by deleting some SEU-supplied displays, or you can 
delete the format member source completely. Be sure you are not 
deleting a display used by another operator. 
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Creating and Changing Displays 



Each SEU-supplied display is defined by a display format. All display 
formats exist originally as a sequence of display format specifications 
(S- and D-specifications) in a source member. The specifications are 
compiled into a load member by the display format generator utility 
program ($SFGR). 

Changing the specifications that define a display format is the first 
step in changing the display itself. 

A complete description of how to design and code display formats, 
how to run $SFGR, and how to design, code, and maintain display 
formats is given in the Creating Displays manual. 

Before you create or change an SEU display format, you should be 
familiar with the restrictions imposed by SEU on the contents of a 
format intended for SEU. 

Restrictions 

• A display format you define for SEU must describe only lines 1 
through 7 of the display. SEU places the seven lines properly on 
the display. SEU requires the other lines for displaying status 
information, prompts, and messages. Although each of lines 1 
through 7 need not be defined, defining a line other than 1 
through 7 causes an error. 

• The start line number (columns 17 and 18 of the display control 
specification, S-specification), must be variable. Enter a V in 
column 17. In addition, enter 00 in columns 19 and 20, for the 
number of lines to clear. 

• Command key or function key masking (columns 27, 28, and 64 
through 79) of the S-specification will be ignored by SEU. 

• You cannot call a message to be shown within the display you are 
creating. 

• Fields to contain heading information, such as column positions, 
must be defined as output fields. Enter Y in column 23 and enter 
C in column 56 of the field definition specification 
(D-specification). 

• Fields to contain data must be defined as input/output fields. 
Enter Y in columns 23 and 26 of the D-specification. By defining 
data fields both as input and as output, you permit SEU to display 
data in the fields after the operator enters data into the fields as 
well as data already existing in the fields. 

• The Z-display must not be deleted from #SE@FORM. There must 
be a Z-display in the format member #SE@FORM or SEU will not 
work. 

• If you create a display format with the same name as a display 
format supplied by SEU, you will overlay the SEU display. 

• The load member #SE@FORM and any other load member that 
contains display formats required by an SEU job, including 
#SE@XTRA, must be in the library you are currently using, in 
#L1BRARY, or in the SEU library (#SEULIB). 
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• A display format can define a maximum of 80 input or 
input/output fields. 

• The total length of the input/output fields defined in a display 
format used by SEU must be at least one but not more than 1 20 
positions. 

When You Should not Change a Display's Name 

The name of the free-form Z-display must not be changed, and the 
Z-dispiay must not be deleted. Z is the display selected by SEU after 
sign-on. If SEU cannot locate a Z-display, SEU displays an error 
message. 

The names of the RPG II, auto report, and WSU displays must not be 
changed or deleted if you want SEU to select the displays and check 
for syntax errors in RPG II and auto report statements. 

Storing New or Changed Displays 

To create a load member that contains displays or to add displays to 
an existing format load member, use the FORMAT procedure. Make 
sure you enter the correct library where the format is to be stored. 
You can use the LISTLIBR procedure to determine whether or not all 
required load members are stored in the same library. The names of 
SEU-supplied members begin with the characters #SE. 

The LISTLIBR and FORMAT procedures are described in the System 
Reference manual. 

It is best to create a new format member for your new display formats 
so that you do not overlay the IBM -supplied displays. 

Do not use the name of a member that already exists in a library as the 
name of a display format member you add. 

The total number of display formats stored in #SE@FORM together 
with those stored in #SE@XTRA (or your own format member) must 
not be greater than 64. In other words, when you press the Select 
Display command key (Cmd 3), up to a maximum of 64 displays are 
available. 
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Glossary 



#LIBRARY. The library, provided with the system, that 
contains the System Support Program Product. See system 
library. 

accumulate. To collect. 

allocate. To assign a resource, such as a disk file or a diskette 
file, to perform a specific task. 

alphabetic character. Any one of the letters A through Z 
(uppercase and lowercase). Some program products extend the 
alphabet to include the special characters #, $, and @. 

alphameric. Consisting of letters, numbers, and often other 
symbols, such as punctuation marks and mathematical symbols. 

alphanumeric. See alphameric. 

assembler. A program that converts assembler language 
statements to machine instructions. 

attribute. A characteristic. 

autoskip option. An option of SEU that allows the cursor to 

automatically skip fields. 

BASIC (beginner's all-purpose symbolic instruction 
code). A programming language designed for interactive 
systems and originally developed at Dartmouth College to 
encourage people to use computers for simple problem-solving 
operations. 

call. To activate a program or procedure at its entry point. 
Compare with load. 

cancel. To end a task before it is completed. 

character. A letter, digit, or other symbol. 

character string. A sequence of consecutive characters. 

code. (1 ) Instructions for the computer. (2) To write 
instructions for the computer. Same as program. (3) A 
representation of a condition, such as an error code. 

collating sequence. The sequence in which characters are 
ordered within the computer for sorting, combining, or 
comparing. 

command. A request to perform an operation or a procedure. 

command display station. A display station from which an 
operator can start and, control jobs. 

command key indicator. An indicator that is set on when 
an operator presses the corresponding command key. 

command keys. The 1 2 keys on the top row of the display 
station keyboard that are used with the Cmd key (and optionally 
the Shift key) to request up to 24 different actions defined for 
program products and user programs. Compare with function 

key. 

comment. Words or statements in a program or procedure 
that serve as documentation rather than as instructions. 

compile. To translate a program written in a high-level 
programming language into a machine language program. 

compress. To move files and libraries together on disk to 
create one continuous area of unused space. 



I concatenate. To remove blanks or control characters 
imbedded in a data string 

constant. A data item with a value that does not change. 
Contrast with variable. 

constant field. A field that is defined by a display format to 

contain a value that does not change. 

cursor. A movable symbol (such as an underline) on a 
display, usually used to indicate to the operator where to type the 
next character. 

default value. A value stored in the system that is used when 
no other value is specified. 

delete. To remove. 

delete-capable file. A file from which records can be 
logically removed without compressing the file. 

delimiter. A character or sequence of characters that marks 
the beginning or end of a unit of data. 

diagnosed -source file. A library member containing source 
statements and associated error messages. 

diagnosed-source member. See diagnosed -source file. 

diagnostic. Pertaining to the detection and isolation of an 
error. 

disk. A storage device made of one or more flat, circular plates 
with magnetic surfaces on which information can be stored. 

diskette. A thin, flexible magnetic plate that is permanently 
sealed in a protective cover. It can be used to store information 
copied from the disk. 

display. (1) A visual presentation of information on a display 
screen. (2) To show information on the display screen. 

display format. Data that defines (or describes) a display. 

display screen. The part of the display station on which 
information is displayed. 

display station. A device that includes a keyboard from 
which an operator can send information to the system and a 
display screen on which an operator can see the information sent 
or receive information from the system. 

edit. (1 ) To modify the form or format of data; for example, to 
insert or remove characters such as for dates or decimal points. 
(2) To check the accuracy of information that has been entered, 
and to indicate if an error is found. 

enter. To type in information on a keyboard and press the 
Enter key in order to send the information to the computer. 

field. One or more characters of related information (such as a 
name or an amount). 

file. (ANSI definition) A set of related records treated as a 
unit. 

format. (1 ) A defined arrangement of such things as 
characters, fields, and tines, usually used for displays, printouts, 
or files. (2) To arrange such things as characters, fields, and 
lines. 
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FORTRAN (formula translation). A high-level 
programming language used primarily for scientific, engineering, 
and mathematical applications. 

free-form format. The SEU display format designed for 
entering and updating statements, such as OCL statements and 
utility control statements, that do not have a constant format. 

function. In BASIC and FORTRAN, a named expression that 

calculates a single value. 

function key. A keyboard key that requests an action but 
does not display or print a character. The cursor movement and 
Help keys are examples of function keys. Compare with 

command keys. 

ID. Identification. 

ideographic character. A two position pictogram or graphic 
character. 

ideographic support. A system support program feature that 
enables the use of ideographic-capable displays, printers, and 
programs. 

informational message. A message that provides 
information to the operator, but does not require a response. 

initial program load (IPL). The process of loading the 
system programs and preparing the system to run jobs. 

input. Data to be processed. 

input/output (I/O). (ANSI definition) Pertaining to either 
input or output, or both. 

IPL. See initial program load. 

job. (1 ) A unit of work to be done by a system. (2) One or 
more related procedures or programs grouped into a procedure. 

key. One or more characters used to identify the record and 
establish the record's order within an indexed file. 

left-adjust. To place or move an entry in a field so that the 
leftmost character of the field is in the leftmost position. Contrast 
with right-adjust. 

library. (1 ) A named area on disk that can contain programs 
and related information (not files). A library consists of different 
sections, called library members. (2) The set of publications for a 
system. ^ 

library member. A named collection of records or statements 
in a library. The types of library members are /oa</ /t?©/??/)©/", 
procedure member, source member, and subroutine member. 

library member subtype. A specific classification of a library 
member type. For example, a source member can be identified as 
a COBOL source member or a DFU source member. 

load. (1 ) To move data or programs into storage. (2) To 
place a diskette into a diskette drive or a magazine into a diskfstte 
magazine drive. (3) To insert paper into a printer. 

load member. A library member that contains information in 
a form that the system can use directly, such as a display format. 
Contrast with source member. 

machine language. A language that can be used directly by 
a computer without intermediate processing. 

macroinstruction. A single instruction that represents a set 
of instructions. 

main storage. The part of the processing unit where 
programs are run. 



mask. A pattern of characters that controls the keeping, 
deleting, or testing of portions of another pattern of characters. 

member. See library member. 

menu. A displayed list of items from which an operator can 
make a selection. 

message. Information sent to an operator or programmer from 
a program. A message can be either displayed or printed. 

message identification code (MIC). A four-digit number 
that identifies a record in a message member. This number can 
be part of the message identification. 

message member. A library member that defines the text of 
each message and its associated message identification code. 

MIC. See message identification code. 

mode. A method of operation. 

numeric. Pertaining to any of the digits 0 through 9. 

OCL. See operation control language. 

online document. A DW/36 term used to describe text that 
may be displayed. 

operation control language (OCL). A language used to 
identify a job and its processing requirements to the System 
Support Program Product. 

output. The result of processing data. 

overlay. (1 ) To write over (and therefore destroy) an existing 
file. (2) A program segment that is loaded into main storage and 
replaces all or part of a previously loaded program segment. 

pad. To fill unused positions in a field with dummy data, 
usually zeros or blanks. 

parameter. A value supplied to a procedure or program that 
either is used as input or controls the actions of the procedure or 

program. 

printout. Information from the computer that is produced by 
a printer. 

procedure. A set of related operation control language 
statements (and, possibly, utility control statements and 
procedure control expressions) that cause a specific program or 
set of programs to be performed. 

procedure command. A command that runs a procedure. 

procedure member. A library member that contains the 
statements (such as operation control language statements) 
necessary to perform a program or set of programs. 

program. (1 ) A sequence of instructions for a computer. See 
source program and load module. (2) To write a sequence of 
instruction^ for a computer. Same as code. 

program product. A licensed program for which a fee is 
charged. 

prompt. A displayed request for information or operator 
action. 

protected field. A displayed field in which operators cannot 
enter data. 

record. A collection of fields that is treated as a unit. 
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recovery procedure. (1) An action performed by the 
operator when an error message appears on the display screen. 
Usually, this action permits the program to continue or permits 
the operator to run the next job. (2) The method of returning the 
system to the point where a major system error occurred and 
running the recent critical jobs again. 

requester. A display station or interactive communications 
session that requests a program to be run. 

right-adjust. To place or move an entry in a field so that the 
rightmost character of the field is in the rightmost position. 
Contrast with left- adjust. 

RPG. A programming language specifically designed for 
writing application programs that meet common business data 
processing requirements. 

screen design aid (SDA). The part of the Utilities Program 
Product that helps the user design, create, and maintain displays 
and menus. Additionally, SDA can generate specifications for 
RPG and WSU work station programs. 

SDA. See screen design aid. 

self-check field. A field, such as an account number, 
consisting of a base number and a check digit. 

serialization. The consecutive numbering of statements. 

SEU. See source entry utility. 

shift in (SI) character (hex OF). The one position character 
at the end of an ideographic character string. 

shift out (SO) character (hex OE). The one position 
character at the front of a ideographic character string. 

sign off. To end a session at a display station. 

sign on. (Verb) To begin a session at a display station. 

source entry utility (SEU). The part of the Utilities Program 
Product used by the operator to enter and update source and 
procedure members. 

source member. A library member that contains information 
in the form in which it was entered, such as RPG specifications. 
Contrast with load member. 

source program. A set of instructions that are written in a 
programming language and that must be translated to machine 
language before the program can be run. 

source statement. A statement written in a programming 
language. 

special character. A character other than an alphabetic or 
numeric character. For example; *, +, and % are special 

characters. 

specification sheets. Forms on which a program is coded 
and described. 



spooling. The part of the System Support Program Product 

that saves output on disk for later printing. 

SSP. See System Support Program Product. 

statement. An instruction in a program or procedure. 

status line. Line 1 of the display which contains general 
information about a job. 

subroutine member. A library member that contains 
information that must be combined with one or more members 
before being run by the system. 

subtype. See library member subtype. 

syntax. The rules for the construction of a statement. 

system library. The library, provided with the system, that 
contains the System Support Program Product and is named 

#LIBRARY. 

system printer. The printer that is used for any printed 
output that is not specifically directed to another printer. 

System Support Program Product (SSP). A group of 
licensed programs that manage the running of other programs 
and the operation of associated devices, such as the display 
station and printer. The SSP also contains utility programs that 
perform common tasks, such as copying information from diskette 
to disk. 

truncate. To shorten a field or statement to a specified length. 

unprotected field. A displayed field for which operators can 
enter, modify, or delete data. 

Utilities Program Product. A program product that 
contains the data file utility (DFU), the source entry utility (SEU), 
the work station utility (WSU), and the screen design aid (SDA). 

utility program. A System Support Program Product 
program that allows you to perform a common task, such as 
copying information from diskette to disk. 

valid. (1 ) Allowed. (2) True, in conforming to an appropriate 

standard or authority. 

variable. A name used to represent a data item yvhose value 
can change while the program is running. Contrast with 
constant. 

work file. A file that is used for temporary storage of data 
being processed. 

work station. A device that lets people transmit information 
to or receive information from a computer; for example, a display 
station or printer. 

work station utility (WSU). The part of the Utilities 
Program Product that helps you to write programs for data entry, 

editing, and inquiry. 

WSU. See work station utility. 
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alter lines per statement 2-11 
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shortcut to calling SEU 5-1 
SI 4-9 

sign-on ideographic 1-11 
signing on to SEU 1 -3, 1-5, 2-2 
skipping fields 2-9 
SO 4-9 

sort comments 4-19 
sort displays 4-1 9 
SORTF display 4-19 
SORTH display 4-19 
SORTRC display 4-19 
SORTRF display 4-19 
source member 2-3 
specification displays 4-1,4-2 
specification sheet 1-9,4-4 
specification sheets 4-1 
SRT programs 2-30 
statement length 1 -6, 2-5 
statement lengths 4-20 
statement numbering 2-21 
status line 2-19,4-4 

autoskip option 2-20 

length of input fields 2-19 

library name 2-20 

member name 2-20 

number of consecutive statements 2-20 

one line per statement 2-20 

print on 2-20 

roll factor 2-19 

syntax checking option 2-20 

type of SEU display 2-19 

work station ID 2-20 
storage 5-6 
storing displays 2-4 
storing members 2-5 
storing new displays 5-12 
storing statement numbers with statements 2-25 
subroutine 2-27, 2-32 
subtype 2-26, 2-27, 2-32 
syntax checki ng 1-12.2-10, 4-12 
syntax diagram 5-1 
syntax errors 2-10 
syntax option 2-10 
system failures 5-9 



Index X-7 



T 



V 



T-display 4-1 1 

temporary statement numbers 1 -29 
temporary storage 1 -31 
translate messages key 2-11 
translating messages 3-31 
translation key 2-11 
type of member 2-3 
types of fields 4-6 

alphameric fields 4-7 

auto-exit fields 4-7 

autoskip fields 4-7 

constant fields 4-7 

numeric fields 4-7 

protect fields 4-7 

right-adjust fields 4-8 



U 

U-display 4-11 

unspecified subtype 2-27, 2-32 
update after scan 2-11 
update key 2-9 
updating statements 1-15 
using enter/update 1 -9, 3-3 
using move/copy 3-5 
using SEU 1-2,3-1 



viewing a member 2-17 
viewing statements 2-16 



W 

ways to use SEU 1 -2 

what is SEU 1-1 

what to call a member 2-2 

when you need help 1 -32 

when your work is interrupted 5-9 

where to store members 2-5 

work area 1 -3, 1 -31 

work file 5-6, 5-9 

wraparound 2-16 

WSU and $SFGR prompting 4-16 

WSU displays 4-13 

WSU-C display 4-13 

WSU- D display 4-13 

WSU-E display 4-13 

WSU-J display 4-13 

WSU- M display 4-13 

WSU-T display 4-13 



z 

Z-display 4-10 

Z- LOWER display 4-10 



X-8 



System/36: Source Entry Utility Guide 



SC21 7901 2 



READER'S COMMENT FORM 



Please use this form only to identify publication errors or to request changes in publications. Direct any 
requests for additional publications, technical questions about IBM systems, changes in IBM programming support, and 
so on, to your IBM representative or to your nearest IBM branch office. You may use this form to communicate your 
comments about this publication, its organization, or subject matter, with the understanding that IBM may use or 
distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. 




If your comment does not need a reply (for example, pointing out a typing error) check this box and do not 
include your name and address below. If your comment is applicable, we will include it in the next revision 
of the manual. 




If you would like a reply, check this box. Be sure to print your name and address below. 



Page number(s): 



Comment(s): 



Please contact your nearest IBM branch office to request 
additional publications. 



Name 



Company or 
Organization 



Address 



No postage necessary if mailed in the U.S.A. 



City 



State Zip Code 



SC21-7901-2 



Fold and tape Please do not staple Fold and tape 



NO POSTAGE 
NECESSARY IF 
MAILED IN THE 
UNITED STATES 



BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 40 ARMONK, N. Y. 



POSTAGE WILL BE PAID BY ADDRESSEE: 




IBM CORPORATION 

Information Development 
Department 245 

Rochester, Minnesota, U.S.A. 55901 




Fold and tape 



Please do not staple 



Fold and tape 



